---
title: "Automatch Metadata to Transaction"
method: POST
path: "/receipts/automatching/metadata"
tags: ["Receipt Automatching"]
---

# Automatch Metadata to Transaction

`POST /receipts/automatching/metadata`

Provide us with metadata about a receipt and we try to find the corresponding transaction for this metadata. Nothing is attached to the transaction, we just provide a matching `transactionId` if found. The more data provided, the better the matching result. This endpoint works **asynchronously** and only starts the automatching process. You will get a callback with the result once it is finished. Or you can query the status yourself.

## Request body

- object
  - `organizationId` string, uuid, required — The organization this receipt metadata belongs to.
  - `metadata` object, required — Metadata to find a matching transaction. The more data provided, the better the matching result.
    - `amountInMinorUnit` integer, required — The amount stated on the receipt, in the minor value of the currency. E.g. `1000` for 10.00, or `13579` for 135.79 or `5` for 0.05. The currency itself it not necessary for automatching.
    - `merchantName` string — The name of the merchant on the receipt.
    - `referenceNumber` string — The number which distinguishes this specific receipt or invoice.
    - `transactionReference` string — The number which references the credit card transaction, if provided with the receipt.
    - `purchaseDate` string, date — The date of the purchase etc. in format ´yyyy-MM-dd´. Can also be the date of the invoice or receipt itself.
    - `cardId` string, uuid — The card the transaction was made with.
    - `cardholderId` string, uuid — The [cardholder](/docs/cardholder-entity) that made the transaction.
    - `cardAccountId` string, uuid — The ID of the [card account](/docs/card-account) this transaction belongs to.

## Response `202`

Accepted

- object
  - `automatchingTaskId` string, uuid, required — The id of the automatching task for later fetching the status of this task. You will also get a callback if subscribed.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) · [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getpliant/pliant-customer-api/revisions/f3f589cfa718/schema)