> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goatpay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Listar disputas MED
> Lista disputas MED do trilho PADRAO com paginação e filtros.
```bash cURL theme={null}
curl -X GET 'https://api.goatpay.com.br/v1/meds/list?page=1&pageSize=50&status=OPEN' \
-H 'X-API-Key: gp_live_SUA_CHAVE'
```
```json Success theme={null}
{
"success": true,
"message": "MEDs listados",
"data": {
"items": [{
"id": "clx_med",
"protocol": "MED-123",
"transactionId": "clx_pix_in",
"status": "OPEN",
"amount": 99.9,
"currency": "BRL",
"reason": "Não reconhecimento",
"infractionId": "inf_abc",
"endToEndId": "E123...",
"openedAt": "2026-05-28T12:00:00.000Z",
"dueAt": "2026-06-04T12:00:00.000Z",
"resolvedAt": null
}],
"page": 1,
"pageSize": 50,
"total": 1,
"pages": 1
},
"requestId": "req_abc"
}
```
### Parâmetros de query
Página (padrão 1).
Itens por página (padrão 50, máx. 100).
ISO 8601 — início (`openedAt`).
ISO 8601 — fim (`openedAt`).
OPEN, UNDER\_REVIEW, ACCEPTED, REJECTED, CANCELED ou EXPIRED.
Busca em id, protocol, transactionId ou providerInfractionId.
## OpenAPI
````yaml GET /meds/list
openapi: 3.1.0
info:
title: GoatPay API
description: >
API pública merchant da GoatPay. Autenticação via header `X-API-Key:
gp_live_...`.
Respostas de sucesso usam o envelope `{ success, message, data, requestId
}`.
Campos internos (`accountId`, `metadata`, histórico de entregas de webhook,
etc.) não são expostos.
`providerTransactionId` aparece como `referenceId`; `providerInfractionId`
como `infractionId`.
Rate limit global: 100 requisições por minuto por API key (HTTP 429). Sem
chave, limite por IP.
version: 1.0.0
servers:
- url: https://api.goatpay.com.br/v1
description: Produção
security:
- apiKeyAuth: []
tags:
- name: pix
description: >-
Cobranças PIX (receber), reembolsos de depósito recebido e transferências
PIX (enviar). Alias legado em payouts/* para envios.
- name: transfer-internal
description: Transferências entre contas GoatPay
- name: transfer-scheduled
description: Transferências programadas (agendar, repetir ou por saldo)
- name: crypto
description: Depósitos e transferências em criptomoeda
- name: billings
description: >-
Cobranças avulsas (pagamento único) — boleto, cartão ou PIX na Conta
Padrão (PF ou PJ)
- name: subscriptions
description: >-
Assinaturas recorrentes com ciclo fixo — boleto, cartão ou PIX na Conta
Padrão (PF ou PJ)
- name: account
description: Saldo e extrato
- name: subaccount
description: Subcontas merchant (carteiras lógicas sob a conta principal)
- name: meds
description: Disputas MED
- name: webhooks
description: Endpoints de webhook de saída
- name: payouts
description: Alias de transfer-pix para saques PIX
- name: customers
description: Clientes da loja (CRM)
- name: products
description: Produtos e entregas digitais
- name: coupons
description: Cupons de desconto para links
- name: payment-links
description: Links de pagamento e checkout hospedado
paths:
/meds/list:
get:
tags:
- meds
summary: Listar disputas MED
description: Disputas MED do trilho PADRAO da conta. Paginação e filtros opcionais.
operationId: listMeds
parameters:
- $ref: '#/components/parameters/ListPage'
- $ref: '#/components/parameters/ListPageSize'
- $ref: '#/components/parameters/ListDateFrom'
- $ref: '#/components/parameters/ListDateTo'
- name: status
in: query
schema:
type: string
enum:
- OPEN
- UNDER_REVIEW
- ACCEPTED
- REJECTED
- CANCELED
- EXPIRED
- $ref: '#/components/parameters/ListSearch'
responses:
'200':
$ref: '#/components/responses/MedListSuccess'
components:
parameters:
ListPage:
name: page
in: query
schema:
type: integer
minimum: 1
default: 1
ListPageSize:
name: pageSize
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 50
ListDateFrom:
name: dateFrom
in: query
schema:
type: string
format: date-time
ListDateTo:
name: dateTo
in: query
schema:
type: string
format: date-time
ListSearch:
name: search
in: query
schema:
type: string
description: >-
Busca parcial em id, description, externalReference, endToEndId,
referenceId e pixKey.
responses:
MedListSuccess:
description: Lista paginada de disputas MED.
content:
application/json:
schema:
type: object
required:
- success
- message
- data
properties:
success:
type: boolean
message:
type: string
data:
$ref: '#/components/schemas/PublicPagedMeds'
requestId:
type: string
schemas:
PublicPagedMeds:
type: object
required:
- items
- page
- pageSize
- total
- pages
properties:
items:
type: array
items:
$ref: '#/components/schemas/PublicMedDispute'
page:
type: integer
pageSize:
type: integer
total:
type: integer
pages:
type: integer
PublicMedDispute:
type: object
properties:
id:
type: string
protocol:
type: string
transactionId:
type: string
status:
type: string
enum:
- OPEN
- UNDER_REVIEW
- ACCEPTED
- REJECTED
- CANCELED
- EXPIRED
amount:
type: number
currency:
type: string
example: BRL
reason:
type: string
infractionId:
type: string
description: >-
Identificador da infração no processador (antes
providerInfractionId).
endToEndId:
type: string
openedAt:
type: string
format: date-time
dueAt:
type: string
format: date-time
resolvedAt:
type: string
format: date-time
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Chave `gp_live_...` criada em Integrações → Chaves de API no dashboard.
````