Accessing Cost Data with APIs

Learn how integrate with Cost APIs.

Creating an API User Token

An API access token is required to access data using the Cost APIs. Tokens are tied to a specific user account, any actions performed will appear as if that user had performed the action themselves.

You must request access to Cost APIs before you will be able to create API tokens. 

  1. Login to Aconex using the account you intend to use for accessing Cost data.
    Note: This account should be restricted to only access the data and perform actions required.
  2. Click the Cost tab, and select Cost Administration.
  3. Click Personal Access Tokens.
  4. Click Create Personal Access Token.
  5. In the popup window, enter a name for the token, and click Generate Token.
  6. Copy the displayed token for future use, you cannot view the token again.
    Note: The token should be kept private and treated like a password.
  7. The API token is used when making http requests. It must be added as a header field: X-User-Access-Token.

Tip!

Cost APIs use a different authenticating method to the other modules.

Accessing Cost API Documentation

Technical information including required fields / parameters, data structures, and API endpoints is available for each instance.

  1. Login to your Aconex instance.
  2. Access the Cost API documentation.
  3. The documentation is categorized into functional areas and shows all the available end points and requirements for each request.

Tip!

You must be logged into Aconex before accessing the documentation.