Get Current Partner Configurations
Usage
Use this endpoint to retrieve the current partner/attribution configuration for your organization's apps.
| Method |
Endpoint |
| GET |
https://api.singular.net/api/v1/partner_configuration/partner_config |
Rate Limit
This endpoint is throttled to 2 requests per minute.
Query Parameters
| Parameter |
Required |
Format |
Description |
Example |
| api_key |
v |
String |
API key provided in the Singular console |
|
| partner_id |
x |
Integer |
Singular partner ID. If omitted, returns configuration for all partners visible to your organization. |
12345 |
| 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. Each row/object represents one postback configuration (install, reengagement, or a specific event) for one app/partner pair.
Response Fields
Configuration
| Field |
Description |
| Partner |
Partner (ad network) display name |
| App |
App name |
| Bundle ID |
The app's Public ID when available, otherwise its bundle ID |
| Public ID |
The app's Singular Public ID |
| Platform |
App platform |
| Agency |
Agency display name, if the configuration is managed via an agency. N/A when not managed by an agency. |
| Accounts |
Partner account login IDs associated with this configuration, when relevant to the partner integration. N/A when not relevant. |
Attribution Windows
| Field |
Description |
| Install Click Window Deterministic |
Install click window, deterministic (days) |
| Install Click Window Probabilistic |
Install click window, probabilistic (hours) |
| Install View Window Deterministic |
Install view window, deterministic (hours) |
| Install View Window Probabilistic |
Install view window, probabilistic (hours) |
| Reeng Click Window Deterministic |
Reengagement click window, deterministic (days) |
| Reeng Click Window Probabilistic |
Reengagement click window, probabilistic (hours) |
| Reeng View Window Deterministic |
Reengagement view window, deterministic (hours) |
| Reeng View Window Probabilistic |
Reengagement view window, probabilistic (hours) |
| Reeng Inactivity Window |
Reengagement inactivity window (days) |
| Ctv View Probabilistic Window |
CTV view window (hours) |
| Ctv Prioritization Window |
CTV prioritization window |
Limited Data Sharing
| Field |
Description |
| Limited Data Sharing restriction Type |
Anonymize , Do not send , or None if unrestricted |
| Limited Data Sharing Default Value |
Default LDS value applied |
Geo Restrictions
| Field |
Description |
| Country Limitation Values |
List of countries under the restriction |
| Country Limitation type |
Include or Exclude
|
Postback / Event
| Field |
Description |
| Event SDK name |
Event name (Install , Reengagement , or a custom event name) |
| Event Type |
Install , Reengagement , Custom , or Revenue
|
| Send All |
Whether postbacks are sent for all installs/re-engagements (or, for event postbacks, all events triggered in the app), regardless of attributed source |
| Send View Through |
Whether conversion postbacks attributed to an impression (view-through) are sent, in addition to click-attributed ones (install/reengagement only) |
| Postback URI |
The URL Singular sends the postback to |
| URI Manually Customized |
Whether the postback URL was manually customized (true ) instead of automatically kept in sync with the partner's latest postback URL (false ) |
| Send Revenue |
Whether the revenue amount is included in the postback (revenue events only) |
| Send Fraud |
Whether fraud rejection postbacks are sent to the partner when a touchpoint is rejected by Singular |
| Event Lookback Type |
The instance from which the postback lookback window starts — click , install , or unlimited (event postbacks only) |
| Event Lookback Window |
The length of time after the lookback starting point during which postbacks are sent to the partner |
| Postback Filters |
The conditions that must be met for a postback to be sent to this partner. Not applicable when Send All is enabled at the partner or event level. |
| Tracker Campaign Name Filter |
When set, postbacks are triggered only for events attributed to this tracker. Not applicable when Send All is enabled. |
| Updated |
Last-updated timestamp |
| Performer |
User who last updated the postback (shown as Singular for internal changes) |
| Partner Parameter 1 Name |
Name of a custom partner-level postback parameter. Additional parameters appear as Partner Parameter 2 Name , Partner Parameter 3 Name , etc. — the number of columns varies by row. |
| Partner Parameter 1 Value |
Value of the corresponding Partner Parameter 1 Name . |
| Event Parameter 1 Name |
Name of a custom event-level postback parameter (event postbacks only). Additional parameters appear as Event Parameter 2 Name , Event Parameter 3 Name , etc. — the number of columns varies by row. |
| Event Parameter 1 Value |
Value of the corresponding Event Parameter 1 Name (event postbacks only). |
Example call
| Method |
Endpoint |
| GET |
https://api.singular.net/api/v1/partner_configuration/partner_config?api_key=YOUR_API_KEY&partner_id=12345 |
Example Output
The output is a CSV file by default (or a JSON array if mode=json is passed). This example shows a representative subset of fields — actual output includes all fields listed above, plus any dynamic parameter columns.
| Partner |
App |
Bundle ID |
Public ID |
Platform |
Agency |
Event SDK name |
Event Type |
Postback URI |
Updated |
Performer |
| ExamplePartner |
ExampleApp |
ExamplePublicId |
ExamplePublicId |
iOS |
ExampleAgency |
Install |
Install |
http://example.url/postback |
2026-02-10 14:00 |
user@company.com |
Tip: If you omit the partner_id parameter, the output includes all partners' configurations for apps visible to your organization.
Errors
| Status |
Meaning |
| 400 |
Invalid partner_id — not a valid integer |
| 429 |
Rate limit exceeded |
| 500 |
Internal error — contact Singular support if it persists |
