Important: This API is currently in pre-release status and is only available to approved early access partners. The API is under development and might change before being generally released. To become an early access partner, contact your SAP Concur Representative.

Getting Started - Company API - User API

The Concur’s company API is used to help provision and manage companies and their profile details across multiple Concur products, including Expense, Invoice, Request, and Travel.

Version

1.0

Schema Definition

The Company schema is inspired by the work from System for Cross-domain Identity Management (SCIM), in particular:

The latest version of the Company schema is always available at: company.json.

Get Company

Each company in Profile is associated with a unique UUID. And your company access token will limit the company you can query for. You can use the following endpoint to lookup your company:

GET /profile/v1/me
(access token required)

Curl example:

curl -k -v -H "Authorization: Bearer $access-token" "https://$host/profile/v1/me"

Company details

Here is a sample company response.

{
  "id": "59c5bfd1-1803-4ca8-b43a-df083a5c60f9",
  "schemas": [
    "com:concur:Travel:0.1",
    "com:concur:Expense:0.1"
  ],
  "internetDomain": "lqy3corexp.com",
  "companyDomain": "lqy3corexp.com",
  "name": "lqy3corexp",
  "defaultLanguage": "en-us",
  "meta": {
    "principalType": "company"
  },
  "com:concur:Expense:0.1": {
    "offeringCode": "CES",
    "marketingName": "CTE"
  },
  "addresses": [
    {
      "formatted": "\n   nil\nUS",
      "streetAddress": "",
      "locality": "",
      "region": "",
      "country": "US",
      "postalCode": null
    }
  ],
  "com:concur:Travel:0.1": {
    "active": 1,
    "offeringCode": "STANDARD",
    "isVendor": false,
    "isBillable": true,
    "contact": {
      "name": "test contact",
      "phone": "",
      "emailAddress": null
    }
  },
  "com:concur:Expense:0.1": {
    "offeringCode": "DIRECT-BREEZE+",
    "marketingName": "Standard Edition",
    "_comment": "If marketingName is 'CTE', then the client is using 'Professional Edition'"
  }
}

HTTP Status Codes

HTTP Status Status Description/Error Code
200 Success Resource retrieved or updated
201 Success Resource created
204 Success Operation executed successfully, with no content returned
301 Moved Permanently Resource is at a different location
400 Bad Request -
401 Unauthorized -
403 Forbidden -
404 Resource not found -
429 Rate limit reached -
500 Internal Error -
503 Service Unavailable -

Enterprise Resource Planning Integration

This API provides the partner with 2 key pieces of information:

  • Company UUID - Partner will record this value per customer connection and use it when submitting Support cases.
  • MarketingName data element - Partner will record this value per customer. This will indicate the edition type a customer is using:
    • CTE or Enterprise means the customer is using Professional Edition.
    • Standard means the customer is using Standard Edition.