Pular para o conteúdo principal
POST
Cancel 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

​
jobId
string<uuid>
obrigatório

Export Job ID

Resposta

Indicates that the request was successful and the response contains the expected data.

​
bytesWritten
integer<int64>
obrigatório

Size of the export file in bytes.

Exemplo:

524288

​
contextId
string<uuid>
obrigatório

Identifier of the reconciliation context this export was queued for (UUID).

Exemplo:

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

​
createdAt
string<date-time>
obrigatório

Timestamp when the job was created (RFC 3339, UTC).

Exemplo:

"2025-01-15T10:30:00Z"

​
expiresAt
string<date-time>
obrigatório

Timestamp after which the export file is purged and no longer downloadable (RFC 3339, UTC).

Exemplo:

"2025-01-16T10:30:00Z"

​
format
enum<string>
obrigatório

File format of the exported report.

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

"CSV"

​
id
string<uuid>
obrigatório

Identifier of the export job (UUID).

Exemplo:

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

​
recordsWritten
integer<int64>
obrigatório

Number of records written to the export file.

Exemplo:

4250

​
reportType
enum<string>
obrigatório

Type of report this job exports.

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

"MATCHED"

​
status
enum<string>
obrigatório

Current lifecycle status: QUEUED (waiting), RUNNING (in progress), SUCCEEDED (complete and downloadable), FAILED (errored), EXPIRED (file no longer available), CANCELED (cancelled by user).

Opções disponíveis:
QUEUED,
RUNNING,
SUCCEEDED,
FAILED,
EXPIRED,
CANCELED
Exemplo:

"SUCCEEDED"

​
downloadUrl
string

Presigned download URL, present only when the job has succeeded and the file is still available.

Exemplo:

"https://storage.example.com/exports/matched_report.csv?token=abc"

​
error
string

Failure reason, present only when the job status is FAILED.

Exemplo:

"timeout exceeded"

​
fileName
string

Generated export file name, present once the job has produced a file.

Exemplo:

"matched_report_2025-01-31.csv"

​
finishedAt
string<date-time>

Timestamp when processing finished, present once the job reaches a terminal state (RFC 3339, UTC).

Exemplo:

"2025-01-15T10:35:00Z"

​
startedAt
string<date-time>

Timestamp when processing started, present once the job has begun running (RFC 3339, UTC).

Exemplo:

"2025-01-15T10:30:05Z"