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=1&sort_column=date&sort_order=DESC&with_deduplication=true&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 and date_to 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

Return data for one advertiser only. Omit to get all advertisers accessible to your key.

integer

Return data for one agency only. It must be your agency or an agency in your portfolio.

integer

Return data for one campaign only.

string

Free-text filter. Matches part of the campaign name, domain, or transaction ID (case-insensitive).

string

default:"date"

Column to sort by. One of: date, our_advertiser_id, our_campaign_id, campaign_name, impressions, clicks, total_spend, transaction_id, domain, conversion_tracker, device, conversion_time, last_click_time, last_impression_time, conversions.

string

default:"DESC"

Sort direction: ASC or DESC.

integer

default:"0"

Page number, starting at 1. Each page has 20 rows. Omit or send 0 to get all rows.

boolean

default:"true"

Deduplicate conversions. Send false to turn it off.

Responses

This endpoint wraps its result in a status / part_error / data envelope. Other reports return data and pagination at the top level.

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": "-",
        "clicks": "-",
        "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": 1,
      "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.

Show object

string

The day of the conversion.

integer

The advertiser ID.

integer

The campaign ID.

string

The campaign name.

integer | string

Number of impressions. For Meta campaigns this is "-", because Meta does not report impressions at this level.

integer | string

Number of clicks. For Meta campaigns this is "-".

number

Spend.

string

The conversion transaction ID.

string

The domain or app where the conversion was attributed.

string

The conversion tracker name.

string

The environment, for example WEB or APP.

string

When the conversion happened.

string | null

The last click before the conversion.

string | null

The last impression before the conversion.

integer

Number of conversions.

object

Pagination metadata.

Show object

integer

The requested page. 0 when all rows are returned.

integer

Total number of 20-row pages.

integer

Total number of records.

Returned if a parameter is missing or invalid. See Errors for all messages.

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

Returned if sort_column or sort_order is not one of the allowed values.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid sort_column: revenue",
    "details": {
      "sort_column": "revenue"
    },
    "request_id": "..."
  }
}

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

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key",
    "details": {
      "field": "X-Api-Key",
      "issue": "invalid"
    },
    "request_id": "..."
  }
}

API documentation

Public endpoints

Method

Endpoint

Headers

Parameters

Responses

Method

Endpoint

​Headers

​Parameters

​Responses

Headers

Parameters

Responses