The Coupon Bureau® Manufacturers API Version 2.0
Manufacturer APIs allow a manufacturer to deposit their own offers into TCB through their own internal systems. APIs are NOT required for a Manufacturer to connect to The Coupon Bureau, these APIs are designed specifically for partners who are looking to integrate these functions into your own system.API functions include Master Offer File deposits, Authorized Partner authorization by account for Master Offer File management, and Provider authorization by Master Offer File for distribution.
- Add Brand POST
- Update Brand PUT
- Get My Brands GET
- Delete Brand DELETE
- Get Connected Providers GET
- Assign Provider to Brand PUT
- Remove Provider from Brand DELETE
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Create / Edit Master Offer File POST
- Update Campaign Metadata POST
- My Master Offer Files GET
- Master Offer File Detail GET
- Get Connected Providers GET
- Assign / Unassign provider to master offer file POST
- Assign / Unassign retailer to master offer file (restricted redemption) POST
- Mandatory retailer selection during deposit PUT
- Assign Provider Custom Circulation POST
- Get Provider Custom Circulation GET
- Delete Provider Custom Circulation DELETE
- Get assigned providers of master offer file GET
- Get assigned retailers of master offer file (restricted redemption) GET
- Lock / Unlock master offer file PUT
- Delete master offer file DELETE
- Attach Lookup Code POST
- Get Lookup Codes of MOF GET
- Get MOF from Lookup Code GET
- Skip Purchase Validation of Lookup Code PUT
- Delete Lookup Code DELETE
- MOF Redemption Errors GET
- MOF Redemption Error with Reason GET
- Update Redemption Days & Timewindow POST
- Delete Redemption Days & Timewindow DELETE
- Extend MOF POST
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Connected Authorized Partners GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- All Funder IDs GET
- All Funder Details GET
- Funder Detail GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Last updated time of Master Offer File GET
- Master Offer File Distribution (with redemption) GET
- Master Offer Files Created Between GET
- Distribution & Redemption between days GET
- Offline Redemption Report GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
Save Access Token for API Playground
How to generate access token?
/access_token
Request Headers
| Content-Type(Optional) | application/json |
| x-api-key | ACCESS_KEY |
Request Body
{
"access_key": "ACCESS_KEY (Get it from enterprise setting page))",
"secret_key": "SECRET_KEY (Get it from enterprise setting page)"
}
Response
{
"status": "success"
"x-access-token": "YOUR ACCESS TOKEN (Valid for 24 hours)"
}
CURL Command
curl -X POST '{{API_SERVER}}/access_token' \
-H 'Content-Type: application/json' \
-H 'x-api-key: ACCESS_KEY' \
--data '{
"access_key": "ACCESS_KEY",
"secret_key": "SECRET_KEY"
}'
x-access-token will be valid for next 24 hours. You can use the same access token to access your API endpoints till it expires.
URL parameters
Request Header
Populate Request JSON Body
CURL Command
Request body JSON
{{ input_body_json_pretty }}
Response body JSON
HTTP Status Code: {{ http_status_code }}
{{ output_body_json_pretty }}
The Coupon Bureau® Authorized Partner API Version 2.0
Authorized Partner APIs allow the ability to connect to the TCB from your internal systems so that you can directly deposit and manage an 8112 offer into a manufacturer’s TCB account. APIs are NOT required for a Authorized Partner to reform your functions as they relate to The Coupon Bureau, these APIs are designed specifically for partners who are looking to integrate these functions into your own system.- Get Connected Manufacturers GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Get Manufacturer Brands GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Create / Edit Master Offer File POST
- Update Campaign Metadata POST
- My Master Offer Files GET
- Master Offer File Detail GET
- Get Manufacturer Providers GET
- Assign / Unassign provider to master offer file POST
- Assign / Unassign retailer to master offer file (restricted redemption) POST
- Mandatory retailer selection during deposit PUT
- Assign Provider Custom Circulation POST
- Get Provider Custom Circulation GET
- Delete Provider Custom Circulation DELETE
- Get assigned providers of master offer file GET
- Get assigned retailers of master offer file (restricted redemption) GET
- Lock / Unlock master offer file PUT
- Delete master offer file DELETE
- Attach Lookup Code POST
- Get Lookup Codes of MOF GET
- Get MOF from Lookup code GET
- Skip Purchase Validation of Lookup code PUT
- Delete Lookup Code DELETE
- MOF Redemption Errors GET
- MOF Redemption Error with Reason GET
- Update Redemption Days & Timewindow POST
- Delete Redemption Days & Timewindow POST
- Extend MOF POST
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Last updated time of Master Offer File GET
- Master Offer File Distribution (with redemption) GET
- Master Offer Files Created Between GET
- Distribution & Redemption between days GET
- Offline Redemption Report GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- All Funder IDs GET
- All Funder Details GET
- Funder Detail GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
How to get Access Token
/access_token
Request Headers
| Content-Type(Optional) | application/json |
| x-api-key | ACCESS_KEY |
Request Body
{
"access_key": "ACCESS_KEY (Get it from enterprise setting page))",
"secret_key": "SECRET_KEY (Get it from enterprise setting page)"
}
Response
{
"status": "success"
"x-access-token": "YOUR ACCESS TOKEN (Valid for 24 hours)"
}
CURL Command
curl -X POST '{{API_SERVER}}/access_token' \
-H 'Content-Type: application/json' \
-H 'x-api-key: ACCESS_KEY' \
--data '{
"access_key": "ACCESS_KEY",
"secret_key": "SECRET_KEY"
}'
x-access-token will be valid for next 24 hours. You can use the same access token to access your API endpoints till it expires.
URL parameters
Request Header
Populate Request JSON Body
CURL Command
Request body JSON
{{ input_body_json_pretty }}
Response body JSON
HTTP Status Code: {{ http_status_code }}
{{ output_body_json_pretty }}
The Coupon Bureau® Provider API Version 2.0
Provider APIs allow a coupon provider to deposit (the GS1 distributed to a consumer) at the time of distribution into a manufacturer’s TCB account. These APIs are required for a provider to participate with TCB. Note: A provider will only be able to deposit serialized GS1s into Master Offer Files of those manufacturers who have authorized them.- Authorized Master Offer Files GET
- Master Offer File Detail GET
- Get Allowed Circulation GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Serialization Prefix GET
- Deposit Serialized GS1s POST
- Create time bound fetch code POST
- Get time bound fetch code GET
- Delete time bound fetch code DELETE
- Validate Serialized GS1s POST
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Deposited Serialized GS1s GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
How to get Access Token
/access_token
Request Headers
| Content-Type(Optional) | application/json |
| x-api-key | ACCESS_KEY |
Request Body
{
"access_key": "ACCESS_KEY (Get it from enterprise setting page))",
"secret_key": "SECRET_KEY (Get it from enterprise setting page)"
}
Response
{
"status": "success"
"x-access-token": "YOUR ACCESS TOKEN (Valid for 24 hours)"
}
CURL Command
curl -X POST '{{API_SERVER}}/access_token' \
-H 'Content-Type: application/json' \
-H 'x-api-key: ACCESS_KEY' \
--data '{
"access_key": "ACCESS_KEY",
"secret_key": "SECRET_KEY"
}'
x-access-token will be valid for next 24 hours. You can use the same access token to access your API endpoints till it expires.
URL parameters
Request Header
Populate Request JSON Body
CURL Command
Request body JSON
{{ input_body_json_pretty }}
Response body JSON
HTTP Status Code: {{ http_status_code }}
{{ output_body_json_pretty }}
The Coupon Bureau® Retailer API Version 2.0
When an AI (8112) serialized data string is scanned at the POS, the POS makes an API request to POF (Positive Offer File) with that serialized data string. The POF will then return the serialized data string with a status of “success” or “Failure” – if “success,” it will also send additional purchase requirement data. The POS then uses the additional purchase requirement data from the API response to validate offer against basket data and apply the discount or send a rollback response if the discount can not be applied.- Redeem Serialized GS1s POST
- Rollback Serialized GS1 DELETE
- Report Redemption Error POST
- Sync Master Offer File GET
- MOF Purchase Requirement from lookup code GET
- Retailer Restricted Base GS1s GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Authorized Accelerators GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Authorized Retailer Clearinghouses GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Redeemed Serialized GS1s GET
- Offline Redeemed Serialized GS1s GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
How to get Access Token
/access_token
Request Headers
| Content-Type(Optional) | application/json |
| x-api-key | ACCESS_KEY |
Request Body
{
"access_key": "ACCESS_KEY (Get it from enterprise setting page))",
"secret_key": "SECRET_KEY (Get it from enterprise setting page)"
}
Response
{
"status": "success"
"x-access-token": "YOUR ACCESS TOKEN (Valid for 24 hours)"
}
CURL Command
curl -X POST '{{API_SERVER}}/access_token' \
-H 'Content-Type: application/json' \
-H 'x-api-key: ACCESS_KEY' \
--data '{
"access_key": "ACCESS_KEY",
"secret_key": "SECRET_KEY"
}'
x-access-token will be valid for next 24 hours. You can use the same access token to access your API endpoints till it expires.
URL parameters
Request Header
Populate Request JSON Body
CURL Command
Request body JSON
{{ input_body_json_pretty }}
Response body JSON
HTTP Status Code: {{ http_status_code }}
{{ output_body_json_pretty }}
The Coupon Bureau® Clearinghouse API Version 2.0
Retailer clearinghouse will be able to view the redemption report of authorized retailers. Retailers connected to The Coupon Bureau® will authorize a clearinghouse to do the final settlement with the manufacturer. Once the clearinghouse is authorized, they will be able to view the redemption data in realtime.- Authorized Retailers GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Retailer Redemption GET
- Retailer Offline Redemption GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Validate Base GS1 GET
- Validate Serialized GS1 GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Get Funder GET
- Get Updated Funders List GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
How to get Access Token
/access_token
Request Headers
| Content-Type(Optional) | application/json |
| x-api-key | ACCESS_KEY |
Request Body
{
"access_key": "ACCESS_KEY (Get it from enterprise setting page))",
"secret_key": "SECRET_KEY (Get it from enterprise setting page)"
}
Response
{
"status": "success"
"x-access-token": "YOUR ACCESS TOKEN (Valid for 24 hours)"
}
CURL Command
curl -X POST '{{API_SERVER}}/access_token' \
-H 'Content-Type: application/json' \
-H 'x-api-key: ACCESS_KEY' \
--data '{
"access_key": "ACCESS_KEY",
"secret_key": "SECRET_KEY"
}'
x-access-token will be valid for next 24 hours. You can use the same access token to access your API endpoints till it expires.
URL parameters
Request Header
Populate Request JSON Body
CURL Command
Request body JSON
{{ input_body_json_pretty }}
Response body JSON
HTTP Status Code: {{ http_status_code }}
{{ output_body_json_pretty }}
The Coupon Bureau® Accelerator API Version 2.0
Accelerators will facilitate retailer connectivity to The Coupon Bureau Positive Offer File. The Coupon Bureau will authorize an Accelerator to execute coupon redemption/ rollback on behalf of multiple retailers. Retailers will use this accelerator connectivity as their connection to The Coupon Bureau Positive Offer File (POF).- Authorized Retailers GET
- Create Retailer POST
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Redeem Serialized GS1s POST
- Rollback Serialized GS1 DELETE
- Report Redemption Error POST
- Sync Master Offer File GET
- MOF Purchase Requirement GET
- MOF Purchase Requirement from lookup code GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
- Retailer Redemption GET
- Retailer Offline Redemption GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
How to get Access Token
/access_token
Request Headers
| Content-Type(Optional) | application/json |
| x-api-key | ACCESS_KEY |
Request Body
{
"access_key": "ACCESS_KEY (Get it from enterprise setting page))",
"secret_key": "SECRET_KEY (Get it from enterprise setting page)"
}
Response
{
"status": "success"
"x-access-token": "YOUR ACCESS TOKEN (Valid for 24 hours)"
}
CURL Command
curl -X POST '{{API_SERVER}}/access_token' \
-H 'Content-Type: application/json' \
-H 'x-api-key: ACCESS_KEY' \
--data '{
"access_key": "ACCESS_KEY",
"secret_key": "SECRET_KEY"
}'
x-access-token will be valid for next 24 hours. You can use the same access token to access your API endpoints till it expires.
URL parameters
Request Header
Populate Request JSON Body
CURL Command
Request body JSON
{{ input_body_json_pretty }}
Response body JSON
HTTP Status Code: {{ http_status_code }}
{{ output_body_json_pretty }}
Developer Access Credentials
To Access The Coupon Bureau® APIAccess Key
Secret Key
Regenerate keys
Do you really want to regenerate the keys? All session / api tokens will be invalidated. There is no undo!
New Secret Key
Please copy your new secret key. This will not be visible once you close this window.
The Coupon Bureau® Sharing App API Version 2.0
These APIs valid for all sharing apps- All Participating Apps GET
- Share Serialized GS1s POST
- Sync Shared Serialized GS1s POST
- Change Phone Number POST
- Sync phone number change POST
- Sync MOF Metadata GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
How to get Access Token
/access_token
Request Headers
| Content-Type(Optional) | application/json |
| x-api-key | ACCESS_KEY |
Request Body
{
"access_key": "ACCESS_KEY (Get it from enterprise setting page))",
"secret_key": "SECRET_KEY (Get it from enterprise setting page)"
}
Response
{
"status": "success"
"x-access-token": "YOUR ACCESS TOKEN (Valid for 24 hours)"
}
CURL Command
curl -X POST '{{API_SERVER}}/access_token' \
-H 'Content-Type: application/json' \
-H 'x-api-key: ACCESS_KEY' \
--data '{
"access_key": "ACCESS_KEY",
"secret_key": "SECRET_KEY"
}'
x-access-token will be valid for next 24 hours. You can use the same access token to access your API endpoints till it expires.
URL parameters
Request Header
Populate Request JSON Body
CURL Command
Request body JSON
{{ input_body_json_pretty }}
Response body JSON
HTTP Status Code: {{ http_status_code }}
{{ output_body_json_pretty }}
The Coupon Bureau® Common API Version 2.0
These APIs are valid for all stakeholders- All Manufacturers GET
- All Providers GET
- All Authorized Partners GET
- All Retailers GET
- All Accelerators GET
- All Clearinghouses GET
- Get Retailer GET
- Live Retailers GET
- Live Stores GET
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
/{{ api_endpoint_orig }}
{{ config[type].name }}
Request
Request Headers
| Name | Type | Description |
|---|---|---|
| Content-Type | string | Required. application/json |
| x-api-key | string | Required. See it in Enterprise Settings page |
| x-access-token | string | Required. how to get access token |
URL Parameters
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc }} |
Request JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Sample Request Body
{{ config[type].sample_request }}
Response JSON Body Attributes
| Name | Type | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.type }} | {{ bodyparam.longDesc ? bodyparam.longDesc : bodyparam.desc }} |
Status codes
| Status Code | HTTP Status Code | Description |
|---|---|---|
| {{ bodyparam.key }} | {{ bodyparam.http_status_code }} | {{ bodyparam.desc }} |
Sample Response Body
{{ config[type].sample_response }}
HTTP Status Code
| Code | Description |
|---|---|
| 200 | Successfully executed. Response body will have status = success. |
| 400 | Request can not be fulfilled. Response body will have status = error along with a message describing the error. |
| 401 | Unauthorized. Either x-access-token is missing or expired. |
| 503 | Service Unavailable. Please refer to status page for more details. |
API Retry Policy: In case of 5XX error, please retry the API call after 10 seconds and again after 20 seconds.
execution_time_in_ms will return the time taken in TCB server to process your request. NOTE: this does not include network latency.
How to get Access Token
/access_token
Request Headers
| Content-Type(Optional) | application/json |
| x-api-key | ACCESS_KEY |
Request Body
{
"access_key": "ACCESS_KEY (Get it from enterprise setting page))",
"secret_key": "SECRET_KEY (Get it from enterprise setting page)"
}
Response
{
"status": "success"
"x-access-token": "YOUR ACCESS TOKEN (Valid for 24 hours)"
}
CURL Command
curl -X POST '{{API_SERVER}}/access_token' \
-H 'Content-Type: application/json' \
-H 'x-api-key: ACCESS_KEY' \
--data '{
"access_key": "ACCESS_KEY",
"secret_key": "SECRET_KEY"
}'
x-access-token will be valid for next 24 hours. You can use the same access token to access your API endpoints till it expires.
URL parameters
Request Header
Populate Request JSON Body
CURL Command
Request body JSON
{{ input_body_json_pretty }}
Response body JSON
HTTP Status Code: {{ http_status_code }}
{{ output_body_json_pretty }}