Zentry.Billing.Api v1.0
Base URLs:
Authentication
- API Key (API_KEY)
- Parameter Name: Api-Key Authentication, in: header.
Employer
GetEmployerBillingProfileLink
GET /Employer/{EmployerId}/profile/link
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
2fa-code | header | string | false | none |
EmployerId | path | string | true | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | GetBillingProfileLinkResponse |
GetEmployerBillingPlans
GET /Employer/plans
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | EmployerBillingPlanIPagedResponse |
Invoice
CreateWorkspaceInvoices
POST /Invoice/workspace/create
Body parameter
{
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateWorksapceInvoicesRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | None |
GetWorkspaceInvoices
POST /Invoice/workspace
Body parameter
{
"offset": 0,
"limit": 25,
"workspaceIds": [
"string"
]
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | GetWorkspaceInvoicesRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | WorkspaceInvoiceIPagedResponse |
GetWorkspaceInvoiceLink
GET /Invoice/workspace/{InvoiceId}/link
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
InvoiceId | path | string | true | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | GetWorkspaceInvoiceLinkResponse |
CompleteWorkspaceInvoice
POST /Invoice/workspace/complete
Body parameter
{
"invoiceId": "string"
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CompleteWorkspaceInvoiceRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | None |
CreateEmployerInvoices
POST /Invoice/employer/create
Body parameter
{
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateEmployerInvoicesRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | None |
GetEmployerInvoices
POST /Invoice/employer
Body parameter
{
"offset": 0,
"limit": 25,
"employerIds": [
"string"
]
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | GetEmployerInvoicesRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | EmployerInvoiceIPagedResponse |
GetEmployerInvoiceLink
GET /Invoice/employer/{InvoiceId}/link
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
InvoiceId | path | string | true | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | GetEmployerInvoiceLinkResponse |
CompleteEmployerInvoice
POST /Invoice/employer/complete
Body parameter
{
"invoiceId": "string"
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CompleteEmployerInvoiceRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | None |
Workspace
GetWorkspaceBillingProfileLink
GET /Workspace/{WorkspaceId}/profile/link
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
2fa-code | header | string | false | none |
WorkspaceId | path | string | true | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | GetBillingProfileLinkResponse |
GetWorkspaceBillingProfile
GET /Workspace/profile
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | WorkspaceBillingProfile |
Schemas
CompleteEmployerInvoiceRequest
{
"invoiceId": "string"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
invoiceId | string | true | none | none |
CompleteWorkspaceInvoiceRequest
{
"invoiceId": "string"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
invoiceId | string | true | none | none |
CreateEmployerInvoicesRequest
{
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
fromDate | string(date-time) | true | none | none |
toDate | string(date-time) | true | none | none |
CreateWorksapceInvoicesRequest
{
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
fromDate | string(date-time) | true | none | none |
toDate | string(date-time) | true | none | none |
EmployerBillingPlan
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"name": "Starter",
"cost": 8000,
"checkInTokens": 60
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | true | none | The unique identifier for this entity |
dateCreated | string(date-time) | true | none | The initial date this entity was created |
dateUpdated | string(date-time) | true | none | The last time this entity was updated |
name | string | true | none | The name of the billing plan |
cost | integer(int64) | true | none | How much this billing plan costs for the employee. Cost is in cents. |
checkInTokens | integer(int32) | true | none | The number of tokens an employee is allocated for per month. |
EmployerBillingPlanIPagedResponse
{
"data": [
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"name": "Starter",
"cost": 8000,
"checkInTokens": 60
}
],
"pagedRequest": {
"offset": 0,
"limit": 25
},
"totalCount": 100
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
data | [EmployerBillingPlan] | true | read-only | The paged data |
pagedRequest | IPagedRequest | true | none | none |
totalCount | integer(int32) | true | read-only | The total number of items available |
EmployerInvoice
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"employerId": "string",
"status": "New",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z",
"total": 0
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | true | none | The unique identifier for this entity |
dateCreated | string(date-time) | true | none | The initial date this entity was created |
dateUpdated | string(date-time) | true | none | The last time this entity was updated |
employerId | string | true | none | none |
status | InvoiceStatus | true | none | none |
fromDate | string(date-time)¦null | false | none | none |
toDate | string(date-time) | true | none | none |
total | integer(int64) | true | none | none |
EmployerInvoiceIPagedResponse
{
"data": [
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"employerId": "string",
"status": "New",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z",
"total": 0
}
],
"pagedRequest": {
"offset": 0,
"limit": 25
},
"totalCount": 100
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
data | [EmployerInvoice] | true | read-only | The paged data |
pagedRequest | IPagedRequest | true | none | none |
totalCount | integer(int32) | true | read-only | The total number of items available |
EmployerInvoiceQuery
{
"offset": 0,
"limit": 25,
"employerIds": [
"string"
]
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
offset | integer(int32) | true | none | How far to skip into a collection |
limit | integer(int32) | true | none | How many results to return |
employerIds | [string]¦null | false | none | none |
GetBillingProfileLinkResponse
{
"link": "string"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
link | string | true | none | none |
GetEmployerInvoiceLinkResponse
{
"link": "string"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
link | string | true | none | none |
GetEmployerInvoicesRequest
{
"offset": 0,
"limit": 25,
"employerIds": [
"string"
]
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | EmployerInvoiceQuery | false | none | none |
and
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | object | false | none | none |
GetWorkspaceInvoiceLinkResponse
{
"link": "string"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
link | string | true | none | none |
GetWorkspaceInvoicesRequest
{
"offset": 0,
"limit": 25,
"workspaceIds": [
"string"
]
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | WorkspaceInvoiceQuery | false | none | none |
and
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | object | false | none | none |
IPagedRequest
{
"offset": 0,
"limit": 25
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
offset | integer(int32) | true | read-only | How far to skip into a collection |
limit | integer(int32) | true | read-only | How many results to return |
InvoiceStatus
"New"
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | string | false | none | none |
Enumerated Values
Property | Value |
---|---|
anonymous | New |
anonymous | Complete |
anonymous | Error |
WorkspaceBillingProfile
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"workspaceId": "string",
"stripeAccountId": "string"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | true | none | The unique identifier for this entity |
dateCreated | string(date-time) | true | none | The initial date this entity was created |
dateUpdated | string(date-time) | true | none | The last time this entity was updated |
workspaceId | string | true | none | none |
stripeAccountId | string | true | none | none |
WorkspaceInvoice
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"workspaceId": "string",
"status": "New",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z",
"total": 0
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | true | none | The unique identifier for this entity |
dateCreated | string(date-time) | true | none | The initial date this entity was created |
dateUpdated | string(date-time) | true | none | The last time this entity was updated |
workspaceId | string | true | none | none |
status | InvoiceStatus | true | none | none |
fromDate | string(date-time)¦null | false | none | none |
toDate | string(date-time) | true | none | none |
total | integer(int64) | true | none | none |
WorkspaceInvoiceIPagedResponse
{
"data": [
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"workspaceId": "string",
"status": "New",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z",
"total": 0
}
],
"pagedRequest": {
"offset": 0,
"limit": 25
},
"totalCount": 100
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
data | [WorkspaceInvoice] | true | read-only | The paged data |
pagedRequest | IPagedRequest | true | none | none |
totalCount | integer(int32) | true | read-only | The total number of items available |
WorkspaceInvoiceQuery
{
"offset": 0,
"limit": 25,
"workspaceIds": [
"string"
]
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
offset | integer(int32) | true | none | How far to skip into a collection |
limit | integer(int32) | true | none | How many results to return |
workspaceIds | [string]¦null | false | none | none |