Skip to main content
POST
Ingest a PRO statement file into statement lines
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /publisher/publishers//statements//ingest Multipart upload (field name file, max 25 MB, any mimetype accepted). Parses the file per source and creates PublisherStatementLine rows. source=MANUAL requires columnMapping (a JSON-encoded object, typically sent as a stringified multipart form field). Authorization: admin role + publisher addon.

Code Examples

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required
statementId
string<uuid>
required

Body

multipart/form-data
source
enum<string>
required

Selects the parser. MANUAL requires columnMapping.

Available options:
BMI,
ASCAP,
MLC,
MANUAL
file
file
required

PRO export file (BMI .txt, ASCAP .csv, MLC .json, or MANUAL .csv). Max 25 MB. Accepted regardless of declared mimetype — PRO export tooling varies.

columnMapping
string

JSON-encoded column mapping object. Required when source=MANUAL; sent as a stringified JSON form field.

sourceLabel
string | null

Response

Lines ingested.

Standard server envelope used by the statement, reconciliation, sub-publishing, and analytics endpoints.

status
enum<string>
Available options:
success,
error
message
string
data
object