|
Method |
Request URI |
HTTP Version |
|
GET |
OLD URL (will be deprecated soon): {OLD EBH domain}/statuses/api/{api version}/history NEW URL (recommended): {NEW EBH domain}/ebh/statuses/{api version}/history Api versions: v1, v2. |
HTTP/1.1 |
URI Parameters
The following table describes required and optional URI parameters.
|
Parameter |
Description |
|
SubmissionId |
Required (either 'SubmissionId' or 'InvoiceId' should be specified). The id returned in the response from Submission API POST request for which to obtain status. |
|
InvoiceId |
Required (either 'SubmissionId' or 'InvoiceId' should be specified). Billing organization’s assigned invoice number or code for which to obtain status. |
Request Headers
The following table describes required and optional request headers.
|
Request header |
Description |
|
ProducerId |
Required. Specifies the client on behalf of which the request is sent. |
|
ProviderKey |
Required. Specifies the access token. |
|
Username |
Optional. Specifies the user on behalf of which the request is sent. The value is used for reporting purposes only and defined by the caller. |
|
Accept |
Optional. Specifies the expected response format. A list of valid values: application/json (default), */*. |
The response includes an HTTP status code, a set of response headers and a response body, which contains an invoice status history.
Status Codes
A successful operation returns status code 200 (OK).
Status code |
Description |
|
200 OK |
The request was successful. See the response body for details. |
|
400 BAD REQUEST |
The request was incorrectly formatted, missing a required header or parameters were invalid. |
|
401 UNAUTHORIZED |
The Provider Key is not authorized. |
|
406 NOT ACCEPTABLE |
Provided Accept HTTP Header is not supported. |
|
500 INTERNAL SERVER ERROR |
Something went wrong. |
Response Headers
|
Response header |
Description |
|
OperationId |
The unique identifier associated with the request. |
Response Body
A request was successfully processed:
The response represents an array of objects.
{
"InvoiceStatuses": [
{
"SubmissionId": "059ca6af-0464-490e-98b9-7b106608dee3",
"InvoiceId": "4326",
"PayorOrgId": "111",
"PayorOrgEBillingId": "222",
"StatusHistory": [
{
"Status": "received",
"StatusDate": "2018-07-07T23:32:57"
},
{
"Status": "ebilled",
"StatusDate": "2018-07-20T23:32:57"
}
]
},
{
"SubmissionId": "059ca6af-0464-490e-98b9-7b106608dee3",
"InvoiceId": "4326",
"PayorOrgId": "222",
"PayorOrgEBillingId": "444",
"StatusHistory": [
{
"Status": "received",
"StatusDate": "2018-07-07T23:32:57"
},
{
"Status": "ebilled",
"StatusDate": "2018-07-22T23:32:57"
}
]
}
]
}
An error occurred while processing a request:
{
"Message": "An unexpected error occurred. Please, contact the support team."
}