Get Withdrawal MED

Use this endpoint to get a specific withdrawal MED by its id.

Available Environments

Production

https://api.gateway.com.br/core

Endpoint

• Method: GET
• Endpoint: /med/withdrawal/{id}
• Authentication: Bearer token

Path Params

Name	Type	Required	Description	Validations
id	string (UUID)	Yes	Identifier of the withdrawal MED	Must be a valid UUID

Request Example

cURL

curl --request GET \
--url https://api.gateway.com.br/core/med/withdrawal/553e8400-e29b-41d4-a716-436251480000 \
--header 'Authorization: Bearer your-jwt-token'

JavaScript

const response = await fetch('https://api.gateway.com.br/core/med/withdrawal/553e8400-e29b-41d4-a716-436251480000', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer your-jwt-token'
  }
});
const data = await response.json();

Success Response

Field	Type	Required	Description
id	string	Yes	MED identifier
acquirer	string	Yes	Acquirer of the MED
endToEnd	string	Yes	End-to-end identifier of the disputed withdrawal
notificationId	string	No	Identifier of the associated notification
withdrawalId	string (UUID)	Yes	Identifier of the disputed withdrawal
status	string (enum) - PENDING, APPEALED, APPROVED, REJECTED	Yes	MED status
origin	string (enum) - USER, ADMIN	Yes	Origin of the opening: USER when opened by you, ADMIN when opened by the operations team
reason	string (enum) - SCAM, FRAUDULENT_ACCESS, OPERATIONAL_ERROR, OTHER	Yes	Reason of the MED
amount	number	Yes	MED amount (integer, in cents)
paymentMethod	string (enum) - PIX	Yes	Payment method
payer	object	No	Payer data (see Sub-Object AccountHolder)
receiver	object	No	Receiver data (see Sub-Object AccountHolder)
message	string	No	Message sent when it was opened
user	object	Yes	User data (see Sub-Object UserVo)
statusHistory	array	Yes	Status history (see Sub-Object StatusHistory)
medDate	string (ISO)	Yes	Date of the MED
createdAt	string (ISO)	Yes	Creation date
updatedAt	string (ISO)	Yes	Last update date

Sub-Objects

StatusHistory (item)

Field	Type	Required	Description
status	string (enum) - PENDING, APPEALED, APPROVED, REJECTED	Yes	MED status in the history
date	string (ISO)	Yes	Date of the status
durationInMilliseconds	number	Yes	Duration of the status in milliseconds

UserVo

Field	Type	Required	Description
name	string	Yes	User name
email	string	Yes	User e-mail
createdAt	string (ISO)	Yes	Creation date of the user

AccountHolder

Field	Type	Required	Description
type	string (enum) - PF, PJ	Yes	Holder type
name	string	Yes	Holder name
document	string	Yes	Holder document
bankAccount	object	Yes	Bank data (see Sub-Object BankAccount)
pix	object	Yes	PIX key of the holder (see Sub-Object PixKeyVo)

BankAccount

Field	Type	Required	Description
type	string	Yes	Account type
digit	string	Yes	Account check digit
ispb	string	Yes	ISPB of the bank

PixKeyVo

Field	Type	Required	Description
key	string	Yes	PIX key
type	string (enum) - CPF, CNPJ, EMAIL, PHONE, EVP	Yes	PIX key type

Response Example

Masked data

Sensitive values may be masked with ***.

{
  "id": "553e8400-e29b-41d4-a716-436251480000",
  "acquirer": "ACQUIRER_EXEMPLO",
  "endToEnd": "E12345678202603061249abcdef0123",
  "notificationId": null,
  "withdrawalId": "553e8400-e29b-41d4-a716-436251480001",
  "status": "PENDING",
  "origin": "USER",
  "reason": "OPERATIONAL_ERROR",
  "amount": 10000,
  "paymentMethod": "PIX",
  "payer": {
    "type": "PJ",
    "name": "Empresa Exemplo LTDA",
    "document": "12345678000199",
    "bankAccount": {
      "type": "CHECKING",
      "digit": "0",
      "ispb": "12345678"
    },
    "pix": {
      "key": "contato@exemplo.com",
      "type": "EMAIL"
    }
  },
  "receiver": {
    "type": "PF",
    "name": "Fulano de Tal",
    "document": "***456789**",
    "bankAccount": {
      "type": "CHECKING",
      "digit": "7",
      "ispb": "12345678"
    },
    "pix": {
      "key": "12345678910",
      "type": "CPF"
    }
  },
  "message": "Saque enviado para a chave errada",
  "user": {
    "name": "Usuário Exemplo",
    "email": "usuario@exemplo.com",
    "createdAt": "2026-01-15T10:00:00.000Z"
  },
  "statusHistory": [
    {
      "status": "PENDING",
      "date": "2026-03-06T12:49:04.681Z",
      "durationInMilliseconds": 1000
    }
  ],
  "medDate": "2026-03-06T12:49:04.681Z",
  "createdAt": "2026-03-06T12:49:04.681Z",
  "updatedAt": "2026-03-06T12:49:04.681Z"
}

Possible Errors

Code	Description	Solution
401	Invalid credentials	Check your credentials
403	No permission/authorization	Contact support
404	Record not found	Check the id you sent
422	Invalid or missing data	Check the format of the data
422	Validations	Contact support
500	Internal error	Contact support