---
title: "Create Audits"
method: POST
path: "/v2/issuers/{organizationId}/users/{userId}/audits"
tags: ["transactions"]
---

# Create Audits

`POST /v2/issuers/{organizationId}/users/{userId}/audits`

## Request

- Base URL: `https://rewards-api.getkard.com`
- URL: `https://rewards-api.getkard.com/v2/issuers/{organizationId}/users/{userId}/audits`
- Auth: HTTP bearer

Call this endpoint to request that a particular transaction be audited further by the Kard system, in the event of a missing cashback claim, incorrect cashback amount claim or other mis-match claims.<br/>
<b>Required scopes:</b> `audit:write`

## Path parameters

- `organizationId` string, required: Your issuer organization ID, provided by Kard
- `userId` string, required

## Request body

- TransactionsCreateAuditRequestBody
  - `data` TransactionsCreateAuditRequestDataUnion[], required
    - `type` 'audit', required: Discriminator value: audit
    - `attributes` TransactionsAuditAttributes, required
      - `auditCode` integer, required: Audit Code - Enum. Please submit the code that is most relevant to your audit request. <ul> <li>`3005` : Customer is claiming cashback is incorrect - INCORRECT CASHBACK CLAIM</li> <li>`3006` : Transaction is missing the cashback award - MISSING CASHBACK AWARD</li> <li>`8001` : Other - check audit description</li> </ul>
      - `merchantName` string, required: Merchant name related to the transaction audit
      - `auditDescription` string, required: Audit Description. Please provide more details around the audit
      - `transactionId` string, required: Transaction ID from issuer to audit

## Response `201`

Response with status 201

- TransactionsCreateAuditResponseBody
  - `data` TransactionsCreateAuditResponseDataUnion[], required
    - `type` 'audit', required: Discriminator value: audit
    - `id` string, required: Audit Request ID
    - `attributes` TransactionsAuditResponseAttributes, required
      - `transactionId` string, required: Cardlinked Transaction ID

## Other responses

- `207`: Error response with status 207
- `400`: Error response with status 400
- `401`: Error response with status 401
- `404`: Error response with status 404
- `409`: Error response with status 409
- `429`: The issuer's traffic grew faster than its allowed rate, or the endpoint's own limit was reached. If the response includes a `Retry-After` header, wait that many seconds before retrying. See [Rate Limits](/2024-10-01/api/integration-guides/rate-limits).
- `500`: Error response with status 500

## Changes

- **2026-10-22** `4e87fc8b018b`: 1 info
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/getkard/apis/getkard-2/changes/v2/issuers/:organizationId/users/:userId/audits/post.md)

---

[API](https://skmtc.dev/getkard/apis/getkard-2.md) - [All operations](https://skmtc.dev/getkard/apis/getkard-2/llms.txt) - [OpenAPI document](https://skmtc.dev/getkard/apis/getkard-2/revisions/bd47764afa21?raw)