> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Listar reivindicacoes > Recupera todas as reivindicacoes associadas a uma conta. Opcionalmente filtre por valores de status da reivindicacao (OPEN, CONFIRMED, COMPLETED, CANCELLED, AWAITING_RESOLUTION). ## OpenAPI ````yaml pt/openapi/v3-current/pix.yaml GET /v1/claims openapi: 3.0.3 info: title: Plugin BR Pix Direct - API Completa description: > API completa para o sistema de pagamentos instantaneos PIX brasileiro, incluindo operacoes de dicionario de chaves PIX, geracao/decodificacao de QR codes, transacoes e limites de transacao. version: 1.0.0 servers: - url: https://plugin-pix-direct.api.lerian.net - url: https://plugin-pix-direct-qrcode.api.lerian.net security: - bearerAuth: [] paths: /v1/claims: get: tags: - API de Reivindicacoes de Chaves summary: Listar reivindicacoes description: > Recupera todas as reivindicacoes associadas a uma conta. Opcionalmente filtre por valores de status da reivindicacao (OPEN, CONFIRMED, COMPLETED, CANCELLED, AWAITING_RESOLUTION). parameters: - $ref: '#/components/parameters/AccountIdQuery' - name: status in: query required: false description: > Filtrar por status da reivindicacao. Valores possiveis: OPEN, CONFIRMED, COMPLETED, CANCELLED, AWAITING_RESOLUTION. schema: type: string example: OPEN responses: '200': description: Lista de reivindicacoes recuperada com sucesso content: application/json: schema: $ref: '#/components/schemas/ClaimListResponse' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' components: parameters: AccountIdQuery: name: account_id in: query required: false description: Identificador da conta. schema: type: string format: uuid example: 019c96a0-0a98-7287-9a31-786e0809c769 schemas: ClaimListResponse: type: object required: - claims properties: claims: type: array description: Lista de reivindicacoes associadas a conta. items: type: object required: - claimType - key - bankId - claimId - stClaim properties: claimType: type: string description: >- Tipo de reivindicacao - PORTABILITY (transferir chave de outro banco) ou OWNERSHIP (reivindicar chave abandonada). enum: - PORTABILITY - OWNERSHIP example: PORTABILITY key: type: string description: Valor da chave PIX. example: '+5511987654321' bankId: type: string description: Codigo ISPB do banco do proprietario atual da chave. example: '12345678' claimId: type: string description: Identificador unico da reivindicacao. example: claim_abc123xyz stClaim: $ref: '#/components/schemas/ClaimStatusEnum' ClaimStatusEnum: type: string description: > Status da reivindicacao de propriedade de chave PIX. Valores string representando o estado de uma reivindicacao de portabilidade ou propriedade. **Valores validos:** - `OPEN` = Reivindicacao foi iniciada e aguarda acao das partes envolvidas - `CONFIRMED` = Reivindicacao foi confirmada pelo reivindicador - `COMPLETED` = Processo de reivindicacao concluido com sucesso, chave transferida - `CANCELLED` = Reivindicacao foi cancelada pelo reivindicador ou pelo sistema - `AWAITING_RESOLUTION` = Aguardando resolucao ou decisao do proprietario atual da chave enum: - OPEN - CONFIRMED - COMPLETED - CANCELLED - AWAITING_RESOLUTION example: OPEN ErrorResponse: type: object properties: code: type: string description: Codigo do erro message: type: string description: Mensagem de erro details: type: array items: type: string description: Detalhes adicionais do erro responses: Unauthorized: description: Nao Autorizado - Autenticacao invalida ou ausente content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_token: summary: Missing authentication token value: code: MISSING_TOKEN message: Authorization header is required details: [] invalid_token: summary: Invalid token value: code: INVALID_TOKEN message: Invalid or expired access token details: [] expired_token: summary: Expired token value: code: TOKEN_EXPIRED message: Access token has expired. Please obtain a new token. details: [] NotFound: description: Nao Encontrado - Recurso nao existe content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: pix_key_not_found: summary: Pix key not found value: code: PIX_KEY_NOT_FOUND message: PIX key does not exist or is not registered details: [] account_not_found: summary: Account not found value: code: ACCOUNT_NOT_FOUND message: Account with specified ID does not exist details: [] transaction_not_found: summary: Transaction not found value: code: TRANSACTION_NOT_FOUND message: Transaction not found details: [] InternalServerError: description: Erro Interno do Servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: generic_error: summary: Generic internal error value: code: INTERNAL_ERROR message: An internal error occurred. Please try again later. details: [] database_error: summary: Database error value: code: DATABASE_ERROR message: Database operation failed details: [] external_service_error: summary: External service error value: code: EXTERNAL_SERVICE_ERROR message: External service (JD PIX) is temporarily unavailable details: [] securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Autenticacao por token JWT Bearer. Obtenha o token no endpoint `/v1/login/oauth/access_token` usando credenciais do cliente (clientId e clientSecret). Inclua o token no header Authorization: `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` O token expira apos 3600 segundos (1 hora). ````