# Listar Links de Pagamento

## Listar links de pagamento

> Retorna uma lista paginada de links de pagamento com filtros opcionais

```json
{"openapi":"3.0.0","info":{"title":"API de Links de Pagamento v2","version":"2.0.0"},"servers":[{"url":"https://api.barte.com","description":"Servidor de produção"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Token-Api"}},"schemas":{"PaymentLinkBasicResponse":{"type":"object","required":["uuid","createdAt","title","url","value"],"properties":{"uuid":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"title":{"type":"string"},"value":{"type":"number","format":"double"},"url":{"type":"string","format":"uri"},"processed":{"type":"integer","format":"int32"}}},"Error":{"type":"object","properties":{"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/ErrorDetail"}},"metadata":{"$ref":"#/components/schemas/Metadata"}}},"ErrorDetail":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}},"Metadata":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time"},"path":{"type":"string"},"method":{"type":"string"}}}}},"paths":{"/v2/payment-links":{"get":{"summary":"Listar links de pagamento","description":"Retorna uma lista paginada de links de pagamento com filtros opcionais","tags":["Links de Pagamento"],"parameters":[{"name":"X-Token-Api","in":"header","required":true,"schema":{"type":"string"},"description":"Token de autenticação para acesso à API"},{"name":"Content-Type","in":"header","required":false,"schema":{"type":"string","enum":["application/json"]},"description":"Tipo de conteúdo da requisição"},{"name":"x-ip-origin-request","in":"header","required":false,"schema":{"type":"string"},"description":"IP de origem da requisição"},{"name":"x-idempotency-key","in":"header","required":false,"schema":{"type":"string"},"description":"Chave de idempotência"},{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["ORDER","SUBSCRIPTION","FAST_ORDER"]},"description":"Tipo do link de pagamento"},{"name":"customerDocument","in":"query","required":false,"schema":{"type":"string"},"description":"Documento do cliente para filtro"},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Nome para filtro"},{"name":"status","in":"query","required":false,"schema":{"type":"string"},"description":"Status do link para filtro"},{"name":"email","in":"query","required":false,"schema":{"type":"string","format":"email"},"description":"Email para filtro"},{"name":"document","in":"query","required":false,"schema":{"type":"string"},"description":"Documento para filtro"},{"name":"notificationEmail","in":"query","required":false,"schema":{"type":"string","format":"email"},"description":"Email de notificação para filtro"},{"name":"paymentMethod","in":"query","required":false,"schema":{"type":"string"},"description":"Método de pagamento para filtro"},{"name":"expirationDateInitial","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data inicial de expiração para filtro"},{"name":"expirationDateFinal","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Data final de expiração para filtro"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","minimum":0,"default":0},"description":"Número da página (começando em 0)"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"default":20},"description":"Quantidade de itens por página"},{"name":"sort","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":false,"description":"Critérios de ordenação (sort=name,asc&sort=createdAt,desc)"}],"responses":{"200":{"description":"Lista de links de pagamento retornada com sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/PaymentLinkBasicResponse"}},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"number":{"type":"integer","format":"int32"},"numberOfElements":{"type":"integer","format":"int32"},"first":{"type":"boolean"},"last":{"type":"boolean"},"empty":{"type":"boolean"}}}}}},"400":{"description":"Erro de validação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Token inativo ou inexistente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Acesso negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Muitas requisições","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Erro interno do servidor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```