Cards v4 - Bulk Request

Get a Bulk Request by ID

Endpoint to retrieve bulk request details by ID. A bulk request represents the processing of an asynchronous bulk APIs such as POST /.../accounts/bulk or POST /.../transactions/bulk.

Scopes

cards.bulkrequest.read - Refer to Scope Usage for full details.

URI

GET https://{datacenterURI}/cards/v4/companies/{companyId}/bulkrequests/{requestId}

Parameters

Name	Type	Format	Description
`companyId`	`string`	-	Required The unique identifier of the SAP Concur company.
`requestId`	`string`	-	Required The unique identifier of the bulk request.

Payloads

Request: None
Response: Bulk Request

Headers

concur-correlationid is a specific custom header used for technical support in the form of a RFC 4122 A Universally Unique IDentifier (UUID) URN Namespace.

HTTP Status Codes

In case of success, HTTP status code 200 (OK) is returned.

To learn more about response HTTP status codes for this API see HTTP Status Codes.

Examples

Request

GET https://us.api.concursolutions.com/cards/v4/companies/1700f4bc-4166-4516-bffe-91d7ae423189/bulkrequests/55e45023-813f-46a2-b83c-1a0b0b7bdda6
Content-Type: application/json
Accept: application/json
Authorization: Bearer {token}
Concur-CorrelationId: a289aaf8-00d1-43af-a3c1-0539083f0789

Response

200 OK
Content-Type: application/json

{
  "requestId": "55e45023-813f-46a2-b83c-1a0b0b7bdda6",
  "status": "COMPLETED_SUCCESSFULLY",
  "receivedAt": "2022-08-17T14:15:23.000Z",
  "completedAt": "2022-08-17T14:16:11.000Z",
  "totalElements": 431,
  "type": "POST_TRANSACTION"
}