### Get Purchase Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/invoice/v4.purchase-request-endpoints.markdown Example of a GET request for purchase request details and its corresponding successful JSON response. ```shell GET /purchaserequest/v4/purchaserequests/de9c0894-b807-6943-8e3f-49a707da3456?mode=COMPACT Authorization: Bearer {token} Content-Type: application/json ``` ```shell HTTP/1.1 200 OK Content-Type: application/json Date: date-requested Content-Length: 1000 concur-correlationid: 1234abcd-12ab-34cd-56ef-123456abcdef ``` ```json { "purchaseRequestId" : "de9c0894-b807-6943-8e3f-49a707da3456", "purchaseRequestNumber" : "100000", "purchaseRequestQueueStatus" : "CREATED", "purchaseRequestWorkflowStatus" : "Approved", "purchaseRequestExceptions": [ { "message": "Line Item Quantity does not match", "eventCode": "PURCH_DETAIL_ITEM_SAVE", "exceptionCode": "0070071", "isCleared": false, "prExceptionId": "fe636831-43a1-9540-bf86-32e2c19400af" } ], "purchaseOrders": [ { "purchaseOrderNumber": "PO10001" } ] } ``` -------------------------------- ### Get All Lists Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/lists/v4.list.markdown This example demonstrates how to make a GET request to retrieve all lists for a company using the List v4 API. Ensure you include the appropriate Accept and Authorization headers. ```shell GET https://us.api.concursolutions.com/list/v4/lists?page=1 Accept: application/json Accept-Language: en Authorization: Bearer {token} ``` -------------------------------- ### Get Payments Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/invoice/v4.invoice-pay.markdown This example demonstrates how to make a GET request to retrieve a list of payments pending retrieval. It includes common headers like Accept and Authorization. ```http GET https://us.api.concursolutions.com/invoice/provider-payment/v4/payments Accept: application/json Authorization: BEARER {token} ``` -------------------------------- ### Example GET Fiscal Year Request Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/budget/v4.fiscal-year.md This example demonstrates how to make a GET request to retrieve a specific fiscal year. It includes the full URL and an Authorization header, which is required for authentication. ```http GET https://us.api.concursolutions.com/budget/v4/fiscalYear/5e58b9b1-fed6-4d36-a5a1-a1ed325931d4 Authorization: Bearer {token} ``` -------------------------------- ### Request Example for Retrieving Mappings Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/accounting-integration/v4.accountingintegration-mappings.markdown An example of a GET request to retrieve configuration settings and mappings, including specific company and ERP IDs. ```shell GET /accountingintegration/v4/companies/09ac834c-46d6-49ff-9653-551d69072d56/erps/2fcffbce-a381-4169-a954-c0395eefd6f6/mappings ``` -------------------------------- ### Example Request to Retrieve Provisioning Status Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/user-provisioning/v4.user-provisioning.md Example of a GET request to check the status of a specific user provisioning request using its UUID. ```shell GET https://{datacenterURI}/profile/v4/provisions/0e00f6a4-6798-4f66-9f47-1e944b619b2e/status ``` -------------------------------- ### GET SCIM v4 Users Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/profile/v4.scim.md Example of a GET request to retrieve a list of users with specific attributes. Ensure to replace placeholders like {datacenterURI} and {token}. ```http GET https://{datacenterURI}/scim/v4/Users?attributes=active Accept: application/json Authorization: Bearer {token} ``` -------------------------------- ### List Users Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/profile/v4.identity.md Example of a GET request to list users. Ensure to replace placeholders like {datacenterURI} and {token}. ```http GET https://{datacenterURI}/profile/identity/v4/Users/ Accept: application/json Authorization: BEARER {token} ``` -------------------------------- ### Get a List by List ID Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/lists/v4.list.markdown This example demonstrates how to make a GET request to retrieve a specific list using its unique identifier. Ensure you include the necessary Accept and Authorization headers. ```shell GET https://us.api.concursolutions.com/list/v4/lists/80edb3fa-c15e-a34a-b97f-f2ec291ab44f Accept: application/json Accept-Language: en Authorization: Bearer {token} ``` -------------------------------- ### Example Request to Get AdminRegion by ID Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/locations/v5.localities.md This example shows how to make a GET request to retrieve details for a specific administrative region using its ID. Ensure you include the appropriate Accept and Authorization headers. ```shell GET https://us2.api.concursolutions.com/localities/v5/adminRegions/3b353fe3-5e4d-4a7a-8230-8eb44db254d0 Accept: application/json Accept-Language: en Authorization: Bearer ${ACCESS_TOKEN} ``` -------------------------------- ### Example Request to Retrieve User Profile Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/user-provisioning/v4.user-provisioning.md This example demonstrates a GET request to retrieve profile data for a specific user using their UUID. ```shell GET https://{datacenterURI}/profile/identity/v4.1/Users/ef0bffaf-863f-4b3e-9c4c-bd9c9a8b2ea7 ``` -------------------------------- ### Get Subscription Response Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/event-topics/index.markdown Example JSON response when retrieving a single subscription's details. Shows the structure of subscription parameters. ```json [ { "id": "my-unique-subscription-id", "topic": "public.test", "filter": ".*", "webHookConfig": { "endpoint": "https://my-valid-endpoint" }, "applicationId": "dabd27f0-23e7-415d-b5e5-19a7dbe4fb4d", "scope": "", "groups": [], "companyIds": [] } ] ``` -------------------------------- ### Retrieve Detailed Provisioning Request Status Request Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/user-provisioning/v4.user-provisioning.md This example shows how to make a GET request to retrieve the detailed status of a specific provisioning request, including operation details. ```shell GET https://{datacenterURI}/profile/v4/provisions/0e00f6a4-6798-4f66-9f47-1e944b619b2e/status?attributes=operations ``` -------------------------------- ### Get Compliance Document Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/document-compliance-gateway/V4.document-compliance-gateway.markdown Example of a GET request to retrieve a compliance document using its ID. Ensure you have the correct JWT token and correlation ID. ```shell curl --location --request GET 'https://integration.api.concursolutions.com/document-compliance-gateway/v4/tax-documents/{documentId}' \ -H 'Authorization: Bearer ' -H 'concur-correlationid: {LogicalId}' ``` -------------------------------- ### Retrieve Supported Schemas Example Request Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/user-provisioning/v4.user-provisioning.md Example of how to make a GET request to retrieve supported schemas. Replace {datacenterURI} with your specific Concur datacenter URI. ```shell GET https://{datacenterURI}/profile/v4/Schemas ``` -------------------------------- ### Get Single Extract Job Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/extracts/v1.extracts.markdown This example demonstrates how to make a GET request to retrieve the details of a specific extract job using its DefinitionID and JobID. ```http GET https://www.concursolutions.com/api/expense/extract/v1.0/nYoPK$pZmcowMRUqcl5bnDAwwsMydyt$xd/job/uIo87jk3SHudi$sdlYle8$peot$pD21jyd Authorization: OAuth {token} ``` -------------------------------- ### Retrieve Supported Resource Types Example Request Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/user-provisioning/v4.user-provisioning.md Example of how to make a GET request to retrieve supported resource types. Replace {datacenterURI} with your specific Concur datacenter URI. ```shell GET https://{datacenterURI}/profile/v4/ResourceTypes ``` -------------------------------- ### Bulk Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/user-provisioning/spend/v4.spend-user-provisioning.md This example demonstrates a bulk request for user provisioning, including operations to replace country, add custom data, and add approver information. ```json { "schemas": [ "urn:ietf:params:scim:api:messages:2.0:BulkRequest", "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "failOnErrors": 1, "Operations": [ { "method": "PATCH", "path": "/Users/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "data": { "Operations": [ { "op": "replace", "path": "urn:ietf:params:scim:schemas:extension:spend:2.0:User:country", "value": "US" }, { "op": "add", "value": { "urn:ietf:params:scim:schemas:extension:spend:2.0:User": { "locale": "es-419", "reimbursementType": "CONCUR_PAY", "customData": [ { "id": "custom1", "value": "patchChangeCustom1" }, { "id": "custom8", "value": "newCustomObject" } ] } } }, { "op": "add", "value": { "urn:ietf:params:scim:schemas:extension:spend:2.0:Approver": { "budget": [ { "approver": { "value": "aaaaaaaa-bbbb-cccc-aaaa-bbbbbbbbbbb3", "employeeNumber": "100001" }, "primary": true } ] } } } ] } } ] } ``` -------------------------------- ### Post New List Item Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/list-item/v1.list-resource-post.markdown Example URL for creating a new list item. Ensure the batch type is set to 'create'. ```http https://www.concursolutions.com/api/expense/list/v1.0/{_listID_}/batch?type=create ``` -------------------------------- ### Get Countries Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/locations/v5.localities.md Example of a GET request to retrieve a list of countries along with their currency codes. Ensure the Authorization header is set with a valid Bearer token. ```shell GET https://us2.api.concursolutions.com/localities/v5/countries Accept: application/json Accept-Language: en Authorization: Bearer ${ACCESS_TOKEN} ``` -------------------------------- ### List Users Response Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/profile/v4.identity.md Example of a successful 200 OK response when listing users, showing pagination details and a list of resources. ```json { "schemas": [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ], "totalResults": 107705, "startIndex": 1, ``` ```json "itemsPerPage": 20, "Resources": [ {User 1 …}, {User 2…}, … {User 20…} ] } ``` -------------------------------- ### Get Country by Country Code Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/locations/v5.localities.md Example GET request to retrieve details for a specific country using its two-letter ISO country code. Requires a valid Authorization header. ```shell GET https://us2.api.concursolutions.com/localities/v5/countries/AF Accept: application/json Accept-Language: en Authorization: Bearer ${ACCESS_TOKEN} ``` -------------------------------- ### GET All Fiscal Years Example Request Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/budget/v4.fiscal-year.md Example of how to call the GET All Fiscal Years endpoint, including query parameters and authorization headers. Use the `lastModifiedAfter` parameter to filter by modification date. ```http GET https://us.api.concursolutions.com/budget/v4/fiscalYear?lastModifiedAfter=2017-02-27T12:30:00 Authorization: Bearer {token} Content-Type: application/json ``` -------------------------------- ### Launch External URL Request Parameters Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/callouts/v4.launch-external-url-concur-request-request.markdown This example shows the structure of a GET request to launch an external URL, including all necessary query parameters for authentication and context. ```http GET https://{URL to your custom connector and endpoint} \ ?logged_in_user_id={URL-encoded login ID of interactive user}& \ request_owner_user_id={URL-encoded login ID of the report owner}& \ company_domain={URL-encoded company domain}& \ repquest_owner_employee_id={URL-encoded client’s Employee ID of the report owner}& \ item_url={URL-encoded url to item}& \ is_mobile={boolean}& \ custom_field_launched_from={URL-encoded custom field identifier}& \ signature={URL-encoded signature hash}& \ nonce={URL-encoded GUID used to generate the signature}& \ client_auth_code={URL-encoded auth code}& \ source={URL-encoded location of the report}& \ language_code={URL-encoded language code of the logged in user} ``` -------------------------------- ### Get Attendee Types v1 Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/expense/attendee-types/v1.attendee-types.markdown Example of a GET request to retrieve a list of attendee types using the v1 API. Ensure to include the Authorization header with a valid OAuth token. ```shell GET https://www.concursolutions.com/api/expense/attendee/v1.0/type Authorization: OAuth {access token} ``` -------------------------------- ### Preview Document Request Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/policy-search/parss-api-documentation.md This example demonstrates a GET request to preview a document, including necessary headers like Authorization and concur-correlationid. ```shell GET https://{datacenterURI}/dg/v4/documents/policy.pdf/preview Authorization: Bearer {access_token} concur-correlationid: 123e4567-e89b-12d3-a456-426614174000 concur-route: route-identifier ``` -------------------------------- ### Retrieve Groups with Filter Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/profile/v4.scim.md Example of a GET request to retrieve groups, filtering by display name. ```http GET https://{datacenterURI}/scim/v4/Groups?filter=displayName eq "Expense User" ``` -------------------------------- ### Example Request URL for All Itemizations Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/expense/expense-report/expense-itemization.markdown An example of a request URL to retrieve expense itemizations, demonstrating the use of limit and user query parameters. ```bash https://www.concursolutions.com/api/v3.0/expense/itemizations?limit=10&user=ALL ``` -------------------------------- ### Get Lists Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/list-item/v1.list-resource-get.markdown This snippet shows the structure of a GET request to retrieve a list of all configured lists. Ensure you include the correct Host and Authorization header. ```shell GET /api/expense/list/v1.0/ HTTPS/1.1 Host: www.concursolutions.com Authorization: OAuth {access token} Content-Type: application/xml ``` -------------------------------- ### Get Image URL Request Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/image/v1.image.markdown Example request to retrieve a URL for an expense entry image. ```shell GET /api/image/v1.0/expenseentry/A2C40CEE415B43B2A0BE Authorization: OAuth {token} Accept: application/xml ``` -------------------------------- ### XML Example GET List Items Request Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/list-item/v1.list-resource-get.markdown This is a basic example of an XML request to retrieve list items. Ensure the Authorization header contains a valid OAuth token. ```shell GET /api/expense/list/v1.0/jUwq11frTd$sweNd7s6s8O0fYi$piWwato/items/ HTTPS/1.1 Host: www.concursolutions.com Authorization: OAuth {access token} Content-Type: application/xml ``` -------------------------------- ### Request Example for Retrieving Vendors Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/accounting-integration/v4.accountingintegration-vendor.markdown An example of a GET request to retrieve vendors from the Accounting Integration API. ```shell GET /accountingintegration/v4/companies/09ac834c-46d6-49ff-9653-551d69072d56/erps/2fcffbce-a381-4169-a954-c0395eefd6f6/vendors ``` -------------------------------- ### Get All Lists API Response - Headers Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/common/lists/v4.list.markdown Example HTTP headers for a successful response from the Get All Lists API. ```shell HTTP/1.1 200 concur-correlationid: 746696dc-8782-4642-815d-3080640786c7 content-length: 5632 content-type: application/json;charset=UTF-8 date: Wed, 08 Jul 2020 02:45:48 GMT etag: "02ebe9fc5c950a031f85c57ac91a0babb" cache-control: no-cache, private ``` -------------------------------- ### Example Request for User Retrieval Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/user-provisioning/spend/v4.1.spend-user-retrieval.md An example of a GET request to retrieve spend data for a user with a specific UUID. ```bash GET https://us2.api.concursolutions.com/profile/spend/v4.1/Users/aaaaaeee-xxxx-zzzz-xxxx-xxxxxxxxxxxx ``` -------------------------------- ### Native Authorization Flow Example Source: https://github.com/sap-docs/preview.developer.concur.com/blob/main/src/api-reference/authentication/authorization-pre-2017.markdown This GET request demonstrates the Native authorization flow, used for prototyping and testing. It requires specific Authorization and X-ConsumerKey headers. ```http GET {uri} Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== X-ConsumerKey: hj7683jslks93lalkjss93 ```