Skip to main content

Zentry.Billing.Api v1.0

Base URLs:

Authentication

  • API Key (API_KEY)
    • Parameter Name: Api-Key Authentication, in: header.

Employer

GET /Employer/{EmployerId}/profile/link

NameInTypeRequiredDescription
2fa-codeheaderstringfalsenone
EmployerIdpathstringtruenone
StatusMeaningDescriptionSchema
200OKOKGetBillingProfileLinkResponse

GetEmployerBillingPlans

GET /Employer/plans

Responses

StatusMeaningDescriptionSchema
200OKOKEmployerBillingPlanIPagedResponse

Invoice

CreateWorkspaceInvoices

POST /Invoice/workspace/create

Body parameter

{
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateWorksapceInvoicesRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKNone

GetWorkspaceInvoices

POST /Invoice/workspace

Body parameter

{
"offset": 0,
"limit": 25,
"workspaceIds": [
"string"
]
}

Parameters

NameInTypeRequiredDescription
bodybodyGetWorkspaceInvoicesRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKWorkspaceInvoiceIPagedResponse

GET /Invoice/workspace/{InvoiceId}/link

NameInTypeRequiredDescription
InvoiceIdpathstringtruenone
StatusMeaningDescriptionSchema
200OKOKGetWorkspaceInvoiceLinkResponse

CompleteWorkspaceInvoice

POST /Invoice/workspace/complete

Body parameter

{
"invoiceId": "string"
}

Parameters

NameInTypeRequiredDescription
bodybodyCompleteWorkspaceInvoiceRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKNone

CreateEmployerInvoices

POST /Invoice/employer/create

Body parameter

{
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateEmployerInvoicesRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKNone

GetEmployerInvoices

POST /Invoice/employer

Body parameter

{
"offset": 0,
"limit": 25,
"employerIds": [
"string"
]
}

Parameters

NameInTypeRequiredDescription
bodybodyGetEmployerInvoicesRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKEmployerInvoiceIPagedResponse

GET /Invoice/employer/{InvoiceId}/link

NameInTypeRequiredDescription
InvoiceIdpathstringtruenone
StatusMeaningDescriptionSchema
200OKOKGetEmployerInvoiceLinkResponse

CompleteEmployerInvoice

POST /Invoice/employer/complete

Body parameter

{
"invoiceId": "string"
}

Parameters

NameInTypeRequiredDescription
bodybodyCompleteEmployerInvoiceRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKNone

Workspace

GET /Workspace/{WorkspaceId}/profile/link

NameInTypeRequiredDescription
2fa-codeheaderstringfalsenone
WorkspaceIdpathstringtruenone
StatusMeaningDescriptionSchema
200OKOKGetBillingProfileLinkResponse

GetWorkspaceBillingProfile

GET /Workspace/profile

Responses

StatusMeaningDescriptionSchema
200OKOKWorkspaceBillingProfile

Schemas

CompleteEmployerInvoiceRequest

{
"invoiceId": "string"
}

NameTypeRequiredRestrictionsDescription
invoiceIdstringtruenonenone

CompleteWorkspaceInvoiceRequest

{
"invoiceId": "string"
}

NameTypeRequiredRestrictionsDescription
invoiceIdstringtruenonenone

CreateEmployerInvoicesRequest

{
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}

NameTypeRequiredRestrictionsDescription
fromDatestring(date-time)truenonenone
toDatestring(date-time)truenonenone

CreateWorksapceInvoicesRequest

{
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}

NameTypeRequiredRestrictionsDescription
fromDatestring(date-time)truenonenone
toDatestring(date-time)truenonenone

EmployerBillingPlan

{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"name": "Starter",
"cost": 8000,
"checkInTokens": 60
}

NameTypeRequiredRestrictionsDescription
idstringtruenoneThe unique identifier for this entity
dateCreatedstring(date-time)truenoneThe initial date this entity was created
dateUpdatedstring(date-time)truenoneThe last time this entity was updated
namestringtruenoneThe name of the billing plan
costinteger(int64)truenoneHow much this billing plan costs for the employee. Cost is in cents.
checkInTokensinteger(int32)truenoneThe 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
}

NameTypeRequiredRestrictionsDescription
data[EmployerBillingPlan]trueread-onlyThe paged data
pagedRequestIPagedRequesttruenonenone
totalCountinteger(int32)trueread-onlyThe 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
}

NameTypeRequiredRestrictionsDescription
idstringtruenoneThe unique identifier for this entity
dateCreatedstring(date-time)truenoneThe initial date this entity was created
dateUpdatedstring(date-time)truenoneThe last time this entity was updated
employerIdstringtruenonenone
statusInvoiceStatustruenonenone
fromDatestring(date-time)¦nullfalsenonenone
toDatestring(date-time)truenonenone
totalinteger(int64)truenonenone

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
}

NameTypeRequiredRestrictionsDescription
data[EmployerInvoice]trueread-onlyThe paged data
pagedRequestIPagedRequesttruenonenone
totalCountinteger(int32)trueread-onlyThe total number of items available

EmployerInvoiceQuery

{
"offset": 0,
"limit": 25,
"employerIds": [
"string"
]
}

NameTypeRequiredRestrictionsDescription
offsetinteger(int32)truenoneHow far to skip into a collection
limitinteger(int32)truenoneHow many results to return
employerIds[string]¦nullfalsenonenone

GetBillingProfileLinkResponse

{
"link": "string"
}

NameTypeRequiredRestrictionsDescription
linkstringtruenonenone

GetEmployerInvoiceLinkResponse

{
"link": "string"
}

NameTypeRequiredRestrictionsDescription
linkstringtruenonenone

GetEmployerInvoicesRequest

{
"offset": 0,
"limit": 25,
"employerIds": [
"string"
]
}

NameTypeRequiredRestrictionsDescription
anonymousEmployerInvoiceQueryfalsenonenone

and

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone

GetWorkspaceInvoiceLinkResponse

{
"link": "string"
}

NameTypeRequiredRestrictionsDescription
linkstringtruenonenone

GetWorkspaceInvoicesRequest

{
"offset": 0,
"limit": 25,
"workspaceIds": [
"string"
]
}

NameTypeRequiredRestrictionsDescription
anonymousWorkspaceInvoiceQueryfalsenonenone

and

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone

IPagedRequest

{
"offset": 0,
"limit": 25
}

NameTypeRequiredRestrictionsDescription
offsetinteger(int32)trueread-onlyHow far to skip into a collection
limitinteger(int32)trueread-onlyHow many results to return

InvoiceStatus

"New"

NameTypeRequiredRestrictionsDescription
anonymousstringfalsenonenone

Enumerated Values

PropertyValue
anonymousNew
anonymousComplete
anonymousError

WorkspaceBillingProfile

{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"workspaceId": "string",
"stripeAccountId": "string"
}

NameTypeRequiredRestrictionsDescription
idstringtruenoneThe unique identifier for this entity
dateCreatedstring(date-time)truenoneThe initial date this entity was created
dateUpdatedstring(date-time)truenoneThe last time this entity was updated
workspaceIdstringtruenonenone
stripeAccountIdstringtruenonenone

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
}

NameTypeRequiredRestrictionsDescription
idstringtruenoneThe unique identifier for this entity
dateCreatedstring(date-time)truenoneThe initial date this entity was created
dateUpdatedstring(date-time)truenoneThe last time this entity was updated
workspaceIdstringtruenonenone
statusInvoiceStatustruenonenone
fromDatestring(date-time)¦nullfalsenonenone
toDatestring(date-time)truenonenone
totalinteger(int64)truenonenone

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
}

NameTypeRequiredRestrictionsDescription
data[WorkspaceInvoice]trueread-onlyThe paged data
pagedRequestIPagedRequesttruenonenone
totalCountinteger(int32)trueread-onlyThe total number of items available

WorkspaceInvoiceQuery

{
"offset": 0,
"limit": 25,
"workspaceIds": [
"string"
]
}

NameTypeRequiredRestrictionsDescription
offsetinteger(int32)truenoneHow far to skip into a collection
limitinteger(int32)truenoneHow many results to return
workspaceIds[string]¦nullfalsenonenone