Authentication endpoints for obtaining access tokens and managing API keys.
Aiwyn API (1.0.0)
The Aiwyn API provides programmatic access to our comprehensive suite of financial automation tools. Build powerful integrations and automate your accounting workflows with our RESTful APIs.
- 🔐 Secure Authentication - Industry-standard OAuth 2.0 and API key authentication
- 📊 Real-time Data - Access up-to-date financial information
- 🚀 High Performance - Low latency, high throughput API infrastructure
- 📚 Comprehensive Coverage - Full access to clients, engagements, expenses, and more
- 🛠️ Developer-Friendly - Extensive documentation, SDKs, and code examples
Request
Work in Progress tracking with comprehensive financial lifecycle management
This advanced endpoint provides complete WIP management including:
- WIP value tracking from creation through billing completion
- Outstanding balance calculations for unbilled work
- Multi-dimensional analysis (client, job, date-based)
- Financial aggregations for WIP reporting and analysis
- Integration with client and job data for complete context
Financial Tracking Features:
- WIP value recording and outstanding balance calculation
- Billed amount tracking for revenue recognition
- Write-off amount management for uncollectible WIP
- Job and client correlation for project profitability
WIP Lifecycle Management:
- Creation date logging for aging analysis
- WIP type categorization (TIME, EXPENSE, FIXED_FEE, etc.)
- Outstanding value calculation for billing preparation
- Billed amount reconciliation for revenue tracking
Business Intelligence & Reporting:
- Client-specific WIP analysis and aging
- Job-based profitability and WIP tracking
- WIP aging reports for collections management
- Revenue recognition and billing pipeline analysis
Financial Aggregations:
- Total WIP value across filtered records
- Outstanding WIP calculations for billing preparation
- Billed amount summaries for revenue analysis
- Write-off tracking for financial reporting
Advanced Filtering:
- Client-specific WIP retrieval and analysis
- Job-based WIP tracking for project management
- Date range queries for period-specific reporting
- WIP type filtering for category analysis
Real Example:
curl --location 'https://{{host}}/v1/wip' \
--header 'Authorization: bearer {{token}} \
--header 'Content-Type: application/json' \
--data '{
"pageSize": 25,
"page": 0
}'Start date for WIP logged date range filter
- Mock serverhttps://api.doc.aiwyn.ai/_mock/bundle/gql/v1/wip
- Staging Environment (Test Data)https://demo.api.aiwyn.ai/gql/v1/wip
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.doc.aiwyn.ai/_mock/bundle/gql/v1/wip \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"pageSize": 25,
"page": 0
}'{ "deid_wip": [ { … }, { … }, { … } ], "deid_wip_aggregate": { "aggregate": { … } } }
Request
Advanced WIP filtering with custom GraphQL where clauses and dynamic ordering
Supports wipType selection, date ranges, and client/job constraints.
Real Example:
curl --location 'https://{{host}}/v1/wips/search' \
--header 'Authorization: bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
"pageSize": 1,
"where": {
"_and": [
{
"_or": [
{
"type": {
"_in": ["TIME", "EXPENSE"]
}
},
{
"notes": {
"_ilike": "%consultation%"
}
}
]
},
{
"approved": {
"_eq": true
}
},
{
"loggedDate": {
"_gte": "1900-01-01T00:00:00Z"
}
},
{
"clientId": {
"_in": [
1001,
1002,
1003
]
}
}
]
},
"orderBy": [
{
"loggedDate": "desc"
},
{
"value": "desc"
}
]
}'GraphQL-style where clause for complex WIP filtering
- Mock serverhttps://api.doc.aiwyn.ai/_mock/bundle/gql/v1/wips/search
- Staging Environment (Test Data)https://demo.api.aiwyn.ai/gql/v1/wips/search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.doc.aiwyn.ai/_mock/bundle/gql/v1/wips/search \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"pageSize": 1,
"where": {
"_and": [
{
"_or": [
{
"type": {
"_in": [
"TIME",
"EXPENSE"
]
}
},
{
"notes": {
"_ilike": "%consultation%"
}
}
]
},
{
"approved": {
"_eq": true
}
},
{
"loggedDate": {
"_gte": "1900-01-01T00:00:00Z"
}
},
{
"clientId": {
"_in": [
1001,
1002,
1003
]
}
}
]
},
"orderBy": [
{
"loggedDate": "desc"
},
{
"value": "desc"
}
]
}'Request
Retrieve a specific work-in-progress (WIP) time entry by its unique identifier
This endpoint provides detailed WIP time entry information including:
- Complete time entry details and descriptions
- Time entry status and approval information
- Client, project, and task relationships
- Billable and non-billable time tracking
- Rate calculations and billing preparation
- Time entry history and modifications
WIP Time Management Features:
- Time entry lifecycle tracking
- Billable vs non-billable time classification
- Rate calculation and billing preparation
- Project and task relationship management
- Approval workflow integration
WIP Time Details Include:
- Time entry description and details
- Time entry status and type
- Client, project, and task information
- Time duration and rates
- Billable calculations
- Approval status
Business Applications:
- Time entry review and approval
- Billable time calculation
- Project time tracking
- Client billing preparation
- Productivity analysis
Real Example:
curl --location 'https://{{host}}/v1/wip/89012' \
--header 'Authorization: bearer {{token}}' \
--header 'Content-Type: application/json'Response Example:
{
"id": 89012,
"description": "Financial statement review and analysis",
"status": "PENDING_APPROVAL",
"type": "BILLABLE",
"staffId": 123,
"staffName": "John Smith",
"clientId": 789,
"clientName": "Acme Corporation",
"projectId": 67890,
"projectName": "Q4 Financial Audit",
"taskId": 456,
"taskName": "Financial Statement Review",
"date": "2024-11-20T00:00:00Z",
"startTime": "2024-11-20T09:00:00Z",
"endTime": "2024-11-20T17:00:00Z",
"duration": 8.0,
"billableHours": 8.0,
"nonBillableHours": 0.0,
"hourlyRate": 250.00,
"billableAmount": 2000.00,
"currency": "USD",
"notes": "Completed comprehensive review of Q4 financial statements including variance analysis",
"approvalHistory": [
{
"id": 1,
"approverId": 124,
"approverName": "Jane Doe",
"approvalDate": "2024-11-21T10:30:00Z",
"status": "PENDING",
"comments": "Under review"
}
],
"createdAt": "2024-11-20T17:30:00Z",
"updatedAt": "2024-11-21T10:30:00Z"
}- Mock serverhttps://api.doc.aiwyn.ai/_mock/bundle/gql/v1/wip/{id}
- Staging Environment (Test Data)https://demo.api.aiwyn.ai/gql/v1/wip/{id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://api.doc.aiwyn.ai/_mock/bundle/gql/v1/wip/89012 \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'WIP time entry details retrieved successfully
Time entry status
Time entry type
Additional notes about the time entry
{ "id": 89012, "description": "Financial statement review and analysis", "status": "PENDING_APPROVAL", "type": "BILLABLE", "staffId": 123, "staffName": "John Smith", "clientId": 789, "clientName": "Acme Corporation", "projectId": 67890, "projectName": "Q4 Financial Audit", "taskId": 456, "taskName": "Financial Statement Review", "date": "2024-11-20T00:00:00Z", "startTime": "2024-11-20T09:00:00Z", "endTime": "2024-11-20T17:00:00Z", "duration": 8, "billableHours": 8, "nonBillableHours": 0, "hourlyRate": 250, "billableAmount": 2000, "currency": "USD", "notes": "Completed comprehensive review of Q4 financial statements including variance analysis", "approvalHistory": [ { … } ], "createdAt": "2024-11-20T17:30:00Z", "updatedAt": "2024-11-21T10:30:00Z" }