Help Center

Get partners

Use this endpoint to fetch a list of partners and associated data.

Before you begin

To use this endpoint, you need an Adjust API token. Follow the instructions in the authentication guide to get your token.

Endpoint

https://api.adjust.com/public/v1/partners

GET request

Fetch a list of partners and associated data. Data are returned in an array of partner objects.

Parameters

Parameter	Data type	In	Description
`after`	String	Query	Cursor to get elements from the next page.
`before`	String	Query	Cursor to get elements from the previous page.
`limit`	Integer	Query	The maximum number of elements included in the response. Needs to be a positive integer value.

Pagination

Results from this endpoint are paginated using a cursor. Each page returns the location of the previous and next pages. You can include these in your calls to return specific pages. You can also limit the number of items included on a page. The default limit is 50.

Each results page contains a "paging" object containing the cursor positions. You can use these cursor positions to programatically move between pages. For example, the first page might contain results like this:

"paging": {
      "page_size": "50",
      "collection_size": "49",
      "total": "199"
      "cursors": {
        "after": "g2wAAAACYhW1_gxkAANuaWxq",
        "before": null
      "next": "https://api.adjust.com/public/v1/apps/yxs12pfewq/trackers?after=g2wAAAACYhW1_gxkAANuaWxq&limit=50",
      "previous": null
    }

To go to the second page, add the after value to the next request in the after parameter. For example:

https://api.adjust.com/public/v1/apps/yxs12pfewq/trackers?after=g2wAAAACYhW1_gxkAANuaWxq

Response

{
  "id": 1,
  "display_name": "String",
  "supports_cost_data": true
}

Fields

Field	Data type	Description	Example
`id`	Integer	The partner's ID.	`174`
`display_name`	String	The partner's name.	`Adcolony`
`support_cost_data`	Boolean	Whether the partner supports cost data.	`true`

Example

cURL

curl --location --request GET 'https://api.adjust.com/public/v1/partners?limit=1' \
--header 'Authorization: Token token={API_TOKEN}'

{
  "data": {
    "api_version": "1",
    "request_id": "FcK55-tdJUDOWQIAABsB",
    "timestamp": "2019-09-09T09:07:06Z",
    "paging": {
      "page_size": "1",
      "collection_size": "1",
      "total": "199",
      "next": "https://api.adjust.com/public/v1/partners?after=g2wAAAACYhW1_gxkAANuaWxq&limit=1",
      "previous": nil,
      "cursors": {
        "after": "g2wAAAACYhW1_gxkAANuaWxq",
        "before": nil
    "items": [
        "id": 174,