Profile v1 - Company

Getting Started - Company API - User API

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

Limitations

This API is only available to partners who have been granted access by SAP Concur. Access to this documentation does not provide access to the API.

Scope Usage

Name Description Endpoint
company.read Read company profile information. GET
company.write Read and update company profile information. GET, POST

Scope Usage

Name Description Endpoint
company.read Read company profile information. GET
company.write Read and update company profile information. GET, POST

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 -

On this page