KIkiwify
MED Incoming Infractions

Get incoming infraction

Changed on

Retrieves a single incoming MED infraction by its id, scoped to the authenticated account.

get/v1/incoming-infractions/{id}

Request

  • Base URL
    https://conta-public-api.kiwify.com
  • URL
    https://conta-public-api.kiwify.com/v1/incoming-infractions/{id}
  • Auth
    API key in header x-access-id and API key in header X-PoP-Challenge and API key in header X-PoP-Format and API key in header X-PoP-Signature

Path parameters

idinteger required

Incoming infraction id

Response

Infraction detail

created_atstring date-time required

Infraction creation timestamp (UTC, RFC 3339).

deadlinestring date-time nullable

Response deadline (UTC, RFC 3339). Derived from funds recovery external_created_at + 7 days when available.

end_to_end_idstring required
idinteger required
infraction_amount_in_centsinteger required

Contested amount. Differs from original_amount_in_cents when the claim is partial.

original_amount_in_centsinteger required
refunded_amount_in_centsinteger required
situation_type'scam_fraud' | 'unauthorized_transaction' | 'coercion_crime' | 'fraudulent_access' | 'others' | 'unknown' required

Situation type from DICT API (SituationType). Set by the creator PSP when creating the Recuperação de Valores.

status'pending' | 'completed' | 'cancelled' required
transaction_idinteger required

Example response

{
  "created_at": "2026-05-28T14:30:00Z",
  "deadline": "2026-05-28T14:30:00Z",
  "funds_recovery": {
    "closed_at": "2026-05-28T14:30:00Z",
    "external_created_at": "2026-05-28T14:30:00Z",
    "external_last_modified_at": "2026-05-28T14:30:00Z"
  },
  "original_transaction": {
    "created_at": "2026-05-28T14:30:00Z"
  }
}

Changes

  • eea178ae3207Revision changes
    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status