---
updatedAt: 2026-06-11T16:02:05.000Z
---

Fetch the complete documentation index at: https://simpay-prod.readme.io/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Get MED Details

Retrieves comprehensive details for a specific MED, including account information, bank details, QR code information, analysis data, and chargeback history.

# MED Details Endpoint

> GET /v3/meds/{med_id}

Retrieves comprehensive details for a specific MED, including account information, bank details, QR code information, analysis data, and chargeback history.

## Authentication

| Header        | Type   | Required | Example                                          |
| :------------ | :----- | :------- | :----------------------------------------------- |
| Authorization | String | Yes      | `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` |

## Path Parameters

| Parameter | Type   | Required | Description                              |
| :-------- | :----- | :------- | :--------------------------------------- |
| med\_id   | String | Yes      | Unique identifier of the MED to retrieve |

## Response (200 OK)

```json
{
  "pix_med_id": "med-123-abc-def",
  "e2e": "E1234567820240115143000123",
  "amount": 1000.50,
  "transaction_date": "2024-01-15T14:30:00",
  "reason": "RETURN_REQUEST",
  "status": "ACCEPTED_BY_PSP",
  "infraction_report_id": "report-456",
  "infraction_report_status": "ANALYZED",
  "origin_situation_type": "SCAM_FRAUD",
  "details": "Detailed description of the dispute",
  "payer_name": "João Silva",
  "payer_document": "12345678901",
  "debited": {
    "ispb": "12345678",
    "bank": "Banco Example",
    "agency": "1234",
    "account": "567890",
    "document": "12345678901",
    "name": "João Silva"
  },
  "credited": {
    "ispb": "35535240",
    "bank": "Example Bank",
    "agency": "0001",
    "account": "123456",
    "document": "98765432000123",
    "name": "Company Name"
  },
  "qrcode_details": {
    "qr_code_id": 123,
    "tx_id": "tx-456",
    "pix_type": "DYNAMIC",
    "status": "PAID",
    "key": "user@example.com",
    "expiration_date": "2024-01-15T23:59:59",
    "due_date": "2024-01-15T23:59:59",
    "copy_and_paste": "00020126580014...",
    "payment_date": "2024-01-15T14:30:00",
    "created_at": "2024-01-15T10:00:00"
  },
  "analysis": {
    "analysis_result": "ACCEPTED",
    "analysis_details_user": "User analysis details",
    "analysis_details_psp": "PSP confirmed fraudulent transaction",
    "internal_notes": null,
    "user_analyzed_by": "Ana Costa",
    "psp_analyzed_by": "Carlos Silva"
  },
  "chargebacks": [
    {
      "status": "SUCCESS",
      "info_text": "Chargeback successful",
      "error_descriptor": null,
      "amount": 1000.50,
      "created_at": "2024-01-16T10:00:00",
      "updated_at": "2024-01-16T10:30:00"
    }
  ],
  "created_at": "2024-01-15T14:30:00",
  "updated_at": "2024-01-16T10:30:00"
}
```

## Response Fields

### Main Fields

| Field                      | Type     | Description                             |
| :------------------------- | :------- | :-------------------------------------- |
| pix\_med\_id               | String   | Unique MED identifier                   |
| e2e                        | String   | End-to-end transaction identifier       |
| amount                     | Decimal  | Disputed amount                         |
| transaction\_date          | Datetime | When the transaction occurred           |
| reason                     | String   | RETURN\_REQUEST or RETURN\_CANCELLATION |
| status                     | String   | Current MED status                      |
| infraction\_report\_id     | String   | Infraction report identifier            |
| infraction\_report\_status | String   | OPEN, RECEIVED, ANALYZED, or CANCELLED  |
| origin\_situation\_type    | String   | Type of fraud situation                 |
| details                    | String   | Dispute description                     |
| payer\_name                | String   | Name of the payer                       |
| payer\_document            | String   | CPF/CNPJ of the payer                   |

### Account Information (debited/credited)

| Field    | Type   | Description             |
| :------- | :----- | :---------------------- |
| ispb     | String | Bank's ISPB code        |
| bank     | String | Bank name               |
| agency   | String | Bank agency code        |
| account  | String | Account number          |
| document | String | Account holder document |
| name     | String | Account holder name     |

### QR Code Details

| Field            | Type     | Description               |
| :--------------- | :------- | :------------------------ |
| qr\_code\_id     | Integer  | QR Code unique identifier |
| tx\_id           | String   | Transaction ID            |
| pix\_type        | Enum     | STATIC or DYNAMIC         |
| status           | Enum     | QR Code status            |
| key              | String   | PIX key used              |
| expiration\_date | Datetime | QR Code expiration        |
| due\_date        | Datetime | Payment due date          |
| copy\_and\_paste | String   | QR Code string            |
| payment\_date    | Datetime | When payment was made     |
| created\_at      | Datetime | QR Code creation date     |

### Analysis Information

| Field                   | Type   | Description                         |
| :---------------------- | :----- | :---------------------------------- |
| analysis\_result        | Enum   | ACCEPTED or REJECTED                |
| analysis\_details\_user | String | User analysis details               |
| analysis\_details\_psp  | String | PSP analysis details                |
| internal\_notes         | String | Internal notes (currently not used) |
| user\_analyzed\_by      | String | Name of user who analyzed           |
| psp\_analyzed\_by       | String | Name of PSP analyst                 |

### Chargeback History

| Field             | Type     | Description                   |
| :---------------- | :------- | :---------------------------- |
| status            | Enum     | PENDING, SUCCESS, or REJECTED |
| info\_text        | String   | Additional information        |
| error\_descriptor | String   | Error description if failed   |
| amount            | Decimal  | Chargeback amount             |
| created\_at       | Datetime | Chargeback creation date      |
| updated\_at       | Datetime | Last update date              |

## Usage Examples

### cURL

```bash
curl --request GET \
  --url https://api.somossimpay.com.br/v3/meds/med-123-abc-def \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

## Error Responses

### 404 Not Found

```json
{
  "detail": "MED not found"
}
```

### 401 Unauthorized

```json
{
  "detail": "Invalid authentication credentials"
}
```

## Related Documentation

* [List MEDs](get_meds_list.md) - List all MEDs with filtering
* [MED API Overview](index.md) - Complete MED API guide

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "3.0.0",
    "title": "Banking & PIX API",
    "description": "Complete API documentation for the banking and PIX payment platform."
  },
  "servers": [
    {
      "url": "https://api.somossimpay.com.br/"
    }
  ],
  "security": [],
  "paths": {
    "/v3/meds/{med_id}": {
      "get": {
        "operationId": "get_med_details",
        "summary": "Get MED Details",
        "description": "Retrieves comprehensive details for a specific MED, including account information, bank details, QR code information, analysis data, and chargeback history.",
        "tags": [
          "MED-API"
        ],
        "parameters": [
          {
            "name": "med_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The unique identifier of the MED infraction report"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters"
          },
          "401": {
            "description": "Unauthorized - Invalid or missing authentication"
          },
          "404": {
            "description": "MED not found"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": true,
    "samples-languages": [
      "curl",
      "python",
      "javascript",
      "java",
      "go"
    ]
  }
}
```