Conversion Report

Maximum date range 365 days

This endpoint is protected and requires an agency API key for access.

  curl --request GET \
    --url 'https://api.growthchannel.io/conversion/?date_from=2026-04-08&date_to=2026-04-14&advertiser_id=123456' \
    --header 'X-Api-Key: your_api_key'

  curl --request GET \
    --url 'https://api.growthchannel.io/conversion/?date_from=2026-04-08&date_to=2026-04-14&advertiser_id=123456&page=0&sort_column=date&sort_order=DESC&with_deduplication=true&with_dsp=false&campaign_id=10001&search=spring' \
    --header 'X-Api-Key: your_api_key'

Method

GET

Endpoint

/conversion/

Headers

string

required

The agency API key used for authorization.

Parameters

Only date_from, date_to, and advertiser_id are required. If you do not need an optional parameter, omit it entirely instead of sending an empty value (for example, avoid page=).

string

required

Start date in YYYY-MM-DD format.

string

required

End date in YYYY-MM-DD format.

integer

required

Unique identifier of the advertiser.

string

Optional free-text search filter.

string

default:"date"

Optional sort column (for example: date, campaign_name, conversions).

string

default:"DESC"

Optional sort direction (ASC or DESC).

integer

default:"0"

Optional page number for pagination (0-based).

boolean

default:"true"

Optional flag to enable conversion deduplication.

boolean

default:"false"

Optional flag to include DSP-specific fields when available.

integer

Optional campaign ID filter.

Responses

200 OK
400 Bad Request
401 Unauthorized
500 Internal Server Error

{
  "status": "success",
  "part_error": {},
  "data": {
    "data": [
      {
        "date": "2026-04-14",
        "our_advertiser_id": 123456,
        "our_campaign_id": 10001,
        "campaign_name": "Sample Q2 Brand Awareness - EN",
        "impressions": 12540,
        "clicks": 212,
        "total_spend": 184.37,
        "transaction_id": "TXN-EXAMPLE-0001",
        "domain": "example-news.com",
        "conversion_tracker": "offsite_conversion.example_purchase",
        "device": "WEB",
        "conversion_time": "2026-04-14 09:24:10",
        "last_click_time": "2026-04-14 09:21:02",
        "last_impression_time": "2026-04-14 09:20:44",
        "conversions": 3
      },
      {
        "date": "2026-04-08",
        "our_advertiser_id": 123456,
        "our_campaign_id": 10002,
        "campaign_name": "Sample Retargeting - Mobile App",
        "impressions": 41697,
        "clicks": 468,
        "total_spend": 320.11,
        "transaction_id": "TXN-EXAMPLE-0002",
        "domain": "social-app",
        "conversion_tracker": "offsite_conversion.example_signup",
        "device": "APP",
        "conversion_time": "2026-04-08 00:00:00",
        "last_click_time": null,
        "last_impression_time": null,
        "conversions": 6145
      }
    ],
    "pagination": {
      "current_page": 0,
      "total_pages": 5,
      "total_count": 89
    }
  }
}

string

Request status value.

object

Partial error container; empty when no partial issues occur.

object

Response payload object.

Show object

array

List of conversion-level records.

object

Pagination metadata.

Show object

integer

Current page number (0-based).

integer

Total number of pages.

integer

Total number of records.

Returned if required query parameters like date_from, date_to, or advertiser_id are missing.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required parameters",
    "details": {
      "missing_fields": ["date_from", "date_to", "advertiser_id"]
    },
    "request_id": "..."
  }
}

Returned if the X-Api-Key header is missing or invalid.

API documentation

Public endpoints

Method

Endpoint

Headers

Parameters

Responses

Method

Endpoint

​Headers

​Parameters

​Responses

Headers

Parameters

Responses