Pular para o conteúdo principal
POST
Create an export job

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication (format: "Bearer {token}")

Cabeçalhos

X-Request-Id
string

A unique identifier for tracing the request across services.

X-Idempotency
string

Optional idempotency key for safe retries. Matcher reads the key only from this header, and only when you send one. A request that carries a key only in X-Idempotency-Key or Idempotency-Key is refused with 400 (MTCH-0015), and nothing is processed. If the same key is sent again and the original request was already processed, the stored response is returned with X-Idempotency-Replayed: true. A malformed key returns 400, a key whose first request is still in progress returns 409, and an idempotency storage failure returns 500. These refusals are problem documents.

Parâmetros de caminho

contextId
string<uuid>
obrigatório

The unique identifier of the reconciliation context. Context ID

Corpo

application/json

Export job parameters

format
enum<string>
obrigatório

Export file format (uppercase only).

Opções disponíveis:
CSV,
JSON,
XML
Exemplo:

"CSV"

reportType
enum<string>
obrigatório

Report type to export (uppercase only).

Opções disponíveis:
MATCHED,
UNMATCHED,
SUMMARY,
VARIANCE,
EXCEPTIONS,
MATCHES,
UNMATCHED_TRANSACTIONS
Exemplo:

"MATCHED"

dateFrom
string<date>

Start date (YYYY-MM-DD). Optional: defaults to 30 days before dateTo.

Exemplo:

"2025-01-01"

dateTo
string<date>

End date (YYYY-MM-DD). Optional: defaults to tomorrow (UTC).

Exemplo:

"2025-01-31"

sourceId
string<uuid>

Optional source ID filter (UUID)

Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

Resposta

Indicates that the request was accepted for processing.

jobId
string<uuid>
obrigatório

Identifier of the newly created export job (UUID).

Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

status
enum<string>
obrigatório

Initial status of the job; always QUEUED on creation.

Opções disponíveis:
QUEUED
Exemplo:

"QUEUED"

statusUrl
string
obrigatório

Relative URL to poll for this job's status.

Exemplo:

"/v1/export-jobs/550e8400-e29b-41d4-a716-446655440001"