# 查询违规记录 (/zh/docs/pix-processamento/endpoints/infractions/get_infractions_by_id)

## GET /user/infractions/{id}

`GET https://api.payzu.processamento.com/v1/user/infractions/{id}`

Get a specific infraction by ID.

Guia: Infractions (MED) (/docs/pix-processamento/tutoriais/infractions)

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `id` | string | yes | Infraction ID |

### Responses

**200** Infraction details

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `id` | string | no | Identifier of the infraction inside PayZu, used in the query routes and when sending the defense. |
| `protocol` | string | no | Infraction code at Bacen. |
| `status` | string | no | Current state of the infraction. — `WAITING_PSP`, `CLOSED`, `OPEN`, `CANCELLED`, `ACKNOWLEDGED`, `DEFENDED`, `ANSWERED`, `WAITING_ADJUSTMENTS` |
| `type` | string | no | Type of the infraction: REFUND_REQUEST, FRAUD or REFUND_CANCELLED. — `REFUND_REQUEST`, `FRAUD`, `REFUND_CANCELLED` |
| `reportedBy` | string | no | Side that opened the infraction: DEBITED_PARTICIPANT or CREDITED_PARTICIPANT. — `DEBITED_PARTICIPANT`, `CREDITED_PARTICIPANT` |
| `reportDetails` | string | null | no | Reason given by whoever opened the infraction, in the text sent by the partner bank. |
| `analysisResult` | string | null | no | Analysis outcome: AGREED or DISAGREED. — `AGREED`, `DISAGREED`, `null` |
| `analysisDetails` | string | null | no | Additional text about the analysis decision, when the partner bank sends that information. |
| `reportedAt` | string | no | Moment the infraction was opened. — format: date-time |
| `expiresAt` | string | null | no | Deadline to send the defense of this infraction. — format: date-time |
| `transaction` | object | no | Summary of the disputed Pix. |
| `transaction.id` | string | no |  |
| `transaction.amount` | number | no | Amount of the disputed transaction, in reais with decimal places. |
| `transaction.payerName` | string | null | no | Name of the Pix payer, as reported by the provider. |
| `transaction.payerDocument` | string | null | no | CPF or CNPJ of the Pix payer, as reported by the provider. |
| `transaction.receiverName` | string | null | no | Name of the Pix receiver, as reported by the provider. |
| `transaction.receiverDocument` | string | null | no | CPF or CNPJ of the Pix receiver, as reported by the provider. |
| `transaction.endToEndId` | string | null | no | End-to-end identifier of the Pix, reported by the provider at settlement. |
| `defenseHistory` | object[] | no | Defenses already sent for this infraction, each with text, status and files. |
| `defenseHistory.id` | string | no | Defense identifier. |
| `defenseHistory.defense` | string | no | Defense text |
| `defenseHistory.status` | string | no | Defense status — `PENDING`, `DEFENDED` |
| `defenseHistory.createdAt` | string | no | Moment the defense was recorded at PayZu, saved together with the uploaded files. — format: date-time |
| `defenseHistory.updatedAt` | string | no | Moment of the last change to the defense. — format: date-time |
| `defenseHistory.files` | object[] | no | Files sent with the defense, with name, type and size in bytes. |
| `defenseHistory.files.name` | string | no | Name of the file sent with the defense. |
| `defenseHistory.files.mimeType` | string | no | MIME type of the file, provided on upload, for example application/pdf or image/png. |
| `defenseHistory.files.size` | integer | no | Size of the file in bytes. — format: int32 |
| `defenseHistory.files.url` | string | null | no | Signed URL for download (expires in 9 minutes). |

**401** Authentication failure

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `status` | string | yes | Fixed marker of an error response. |
| `error` | string | yes | Name of the corresponding HTTP status. |
| `errorCode` | string | yes | Stable machine-readable error code, when available. |
| `message` | string | yes | Human-readable error message. |
| `statusCode` | integer | yes | HTTP status code. |
| `requestId` | string | yes | Unique request correlation ID (cuid). Include it when contacting support. |
| `details` | object[] | no | Field-level validation errors, when applicable. |
| `details.field` | string | yes | Path of the field rejected in validation, without the leading slash. |
| `details.message` | string | yes | Reason that field was rejected, in Portuguese. |
| `retryAfterSeconds` | integer | no | Seconds to wait before retrying. Present only on 429 responses. |

**404** Infraction not found

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `status` | string | yes | Fixed marker of an error response. |
| `error` | string | yes | Name of the corresponding HTTP status. |
| `errorCode` | string | yes | Stable machine-readable error code, when available. |
| `message` | string | yes | Human-readable error message. |
| `statusCode` | integer | yes | HTTP status code. |
| `requestId` | string | yes | Unique request correlation ID (cuid). Include it when contacting support. |
| `details` | object[] | no | Field-level validation errors, when applicable. |
| `details.field` | string | yes | Path of the field rejected in validation, without the leading slash. |
| `details.message` | string | yes | Reason that field was rejected, in Portuguese. |
| `retryAfterSeconds` | integer | no | Seconds to wait before retrying. Present only on 429 responses. |