Profiles API

You can use the Profiles API to programmatically run your Profiles project and check its run status.

Prerequisites

• Set up a Profiles project in the RudderStack dashboard.
• Generate a Personal access token with read-write access.

Authentication

The Profiles API uses Bearer authentication in the following format:

Authorization: Bearer <PERSONAL_ACCESS_TOKEN>

Base URL

Use the base URL for your API requests depending on your region:

https://api.rudderstack.com/v2

https://api.eu.rudderstack.com/v2

Run project

You can trigger the run of a Profiles project using the below endpoint:

To obtain the source ID, go to your project in the RudderStack dashboard and note it down from the URL:

Path parameters

Request body

Example request

POST /v2/sources/<source_id>/start HTTP/1.1
Host: api.rudderstack.com
Content-Type: application/json
Accept: application/json
Authorization: Bearer <token>

curl --location 'https://api.rudderstack.com/v2/sources/<source_id>/start' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Example response

{
  "runId": "<run_id>"
}

Response codes

Get run status

You can get the run status of your Profiles project using the below endpoint:

Path parameters

You can obtain the runId as the response of the above API endpoint (/sources/<sourceID>/start).

Example request

GET /v2/sources/<source_id>/runs/{run_id}/status HTTP/1.1
Host: api.rudderstack.com
Accept: application/json
Authorization: Bearer <token>

curl --location 'https://api.rudderstack.com/v2/sources/<source_id>/runs/<run_id>/status' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Example response

{
  "jobId": "string",
  "jobRunId": "string",
  "status": "string",
  "startedAt": "2024-05-31T06:48:08.228Z",
  "finishedAt": "2024-05-31T06:48:08.228Z",
  "tasks": [{
    "taskId": "string",
    "taskRunId": "string",
    "startedAt": "2024-05-31T06:48:08.228Z",
    "finishedAt": "2024-05-31T06:48:08.228Z"
  }]
}

Response codes

Questions? Contact us by email or on Slack