Skip to main content
POST
Match Splits
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

/split/match Description:
The /split/match endpoint finds splits that match the specified criteria. It allows filtering splits by territory, DSP, usage type, and date.
Authorization:
  • Required role: user or higher
Method:
POST
Request Body: The request body should be a JSON object with any of the following properties. At least one property must be provided.

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
territory
string
required

ISO 3166-1 alpha-2 country code (e.g., 'US', 'NG')

Example:

"NG"

dsp
string

Digital Service Provider identifier

Example:

"spotify"

usageType
string

Type of usage

Example:

"stream"

date
string<date>

Date to check for active splits (ISO 8601 format)

Example:

"2023-06-01"

Response

Success

count
integer

Number of matching splits found

splits
object[]

Array of matching splits