---
updatedAt: 2026-04-06T17:53:05.000Z
agentTools:
  projectIndex: https://docs.pagar.me/llms.txt
---

# Retornando Contestações

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "pagarme-api-register-v5",
    "version": "5"
  },
  "servers": [
    {
      "url": "https://api.pagar.me/register/v5"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/contestations": {
      "get": {
        "summary": "Retornando Contestações",
        "description": "",
        "operationId": "retornando-contestacoes",
        "parameters": [
          {
            "name": "contract_key",
            "in": "query",
            "description": "Chave Identificadora do contrato",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Paginação",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "size",
            "in": "query",
            "description": "Quantidade de Itens (Contestações) a serem retornardos",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "id",
            "in": "query",
            "description": "Chave Identificadora da Contestação que foi aberta",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "original_assetHolder_document",
            "in": "query",
            "description": "Documento do originador da UR",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "description": "Status da Contestação (Código do motivo da contestação. A lista dos códigos está na Response code 200 Enum de System)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "created_at",
            "in": "query",
            "description": "Data de Abertura da Contestação",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "Response 200\n{\n\t\"data\": [\n\t\t{\n\t\t\t\"id\": \"string\",\n\t\t\t\"status\": \"string\",\n\t\t\t\"contested_document\": \"string\",\n\t\t\t\"original_asset_holder_document\": \"string\",\n\t\t\t\"reason_code\": \"string\",\n\t\t\t\"contract_key\": \"string\",\n\t\t\t\"created_at\": \"Date time\",\n\t\t\t\"reason_description\": \"string\",\n\t\t\t\"description\": \"string\",\n\t\t\t\"skip_contract\": boolean\n\t\t}\n\t],\n\t\"paging\": {\n\t\t\"total\": int,\n\t\t\"previous\": \"string\",\n\t\t\"next\": \"string\"\n\t}\n}"
                  }
                }
              },
              "text/plain": {
                "examples": {
                  "Status Code": {
                    "value": "Enum de ReasonCode:\n{\n  // Códigos Legado\n  [Description(\"Contestação com base em rejeição bancária onde a conta teve um erro ao ser invalidada\")]\n  SO07 = 7,\n  \n  [Description(\"Contestação com base em rejeição bancária indevida por parte da ID\")]\n  SO08 = 8,\n  \n  [Description(\"Contestação com base em revogação de optin por parte de um credor\")]\n  SO09 = 9,\n  \n  [Description(\"Contestação com base em evidência do EC de que o contrato é indevido\")]\n  SO10 = 10,\n  \n  [Description(\"Contestação com base em rejeição por falta de acordo entre o banco e a bandeira no SLC\")]\n  SO11 = 11,\n  \n  // Códigos atuais\n  [Description(\"Problemas para liquidação do instrumento contratual ocasionado pelos dados bancários inválidos\")]\n  SO01 = 1,\n  \n  [Description(\"Titular ou usuário final recebedor não reconhece a operação\")]\n  SO02 = 2,\n  \n  [Description(\"Duplicidade de lançamento de operação\")]\n  SO03 = 3,\n  \n  [Description(\"Operação em divergência com o instrumento contratual\")]\n  SO04 = 4,\n  \n  [Description(\"Outros\")] SO05 = 5,\n  \n  [Description(\"Divergência entre valor esperado pelo financiador ou pela não financeira e o valor efetivamente liquidado pela instituição credenciadora ou subcredenciadora devedora da obrigação\")]\n  SO06 = 6,\n  \n  [Description(\"Ausência de liquidação\")]\n  SO12 = 12,\n  \n  [Description(\"Gravame baixado ainda recebendo liquidações na conta indicada\")]\n  SO13 = 13,\n  \n  [Description(\"Titular ou usuário final recebedor não reconhece a anuência\")]\n  SO15 = 15,\n  \n  [Description(\"Comunicação de resilição ou liberação de excedente não atendida\")]\n  SO14 = 14,\n  \n  [Description(\"Não recebimento da agenda solicitada\")]\n  SO16 = 16,\n  \n  [Description(\"Divergência de valores na agenda\")]\n  SO17 = 17,\n  \n  [Description(\"Outros\")] \n  SO18 = 18,\n  \n  [Description(\"Comunicação de resilição ou liberação de excedente indevida\")]\n  SO19 = 19\n}"
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "text",
              "code": "{\n  contract_key: string\n  page: int\n\tsize: int\n}"
            }
          ],
          "samples-languages": [
            "text"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```