Configuration changes have been tracked starting February 4th, 2026 . Data prior to this date is not available.
Get Partner Configuration Changes
Usage
Use this endpoint to retrieve a log of every update made to a specific partner setup.
| Method | Endpoint |
|---|---|
| GET | https://api.singular.net/api/v1/partner_configuration/partner_config_changes |
Rate Limit
This endpoint is throttled to 5 requests per minute.
Query Parameters
| Parameter | Required | Format | Description | Example |
|---|---|---|---|---|
| api_key | v | String | API key provided in the Singular console | |
| partner_name | x | String | Partner display name. Use the Get Configured Partners API to retrieve these. If omitted, the output includes all partners. | 1Plusads |
| longname | v | String | The App Bundle ID. Use the Get Apps API to retrieve these. | com.example.app |
| platform | v | String | The platform of the app. Allowed values are: web, ios, android, playstation, xbox, metaquest, pc, nintendo. |
ios |
| agency_id | x | String | Optional identifier if the configuration is managed via an agency. | |
| start_date | x | ISO 8601 | Restrict results to changes on or after this date/time. If no timezone is given, UTC is assumed. | 2026-02-01 |
| end_date | x | ISO 8601 | Restrict results to changes on or before this date/time. If no timezone is given, UTC is assumed. | 2026-02-15T00:00:00Z |
| mode | x | String |
json returns JSON, otherwise CSV. |
json |
Response Format
By default this endpoint returns a CSV file. Pass mode=json to receive the same data as a JSON array of objects instead.
Example call
Use this endpoint to retrieve a log of every update made to a specific partner setup.
| Method | Endpoint |
|---|---|
| GET | https://api.singular.net/api/v1/partner_configuration/partner_config_changes?api_key=YOUR_API_KEY&partner_name=ExamplePartner&platform=iOS&longname=com.example.app.bundleid |
Example Output
The output is a CSV file by default (or a JSON array if mode=json is passed). Each row/object represents a single field change within the partner configuration:
| Date | Partner | App | Bundle ID | Site Public ID | Platform | Agency | Category | Field Name | Old Value | New Value | Performer | Operation |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2026-02-10 14:00 | ExamplePartner | ExampleApp | com.example.app.bundleid | ExamplePublicId | iOS | ExampleAgency | Postbacks | postback_uri | http://old.url | http://new.url | user@company.com | Update |
| 2026-02-11 09:30 | ExamplePartner | ExampleApp | com.example.app.bundleid | ExamplePublicId | iOS | ExampleAgency | Windows | Install Click Window (Probabilistic) Hours | 24 | 6 | Singular | Update |
Tip: If you omit the
partner_name parameter the output will include all partners.Errors
| Status | Meaning |
|---|---|
| 400 | Invalid partner_name
|
| 400 | Only one of longname /platform was provided — both are required together |
| 400 | No app exists for the given longname and platform
|
| 400 | Invalid start_date /end_date — not a valid ISO 8601 value |
| 500 | Internal error — contact Singular support if it persists |