# Get agreement

This endpoint allows returning information on an existing link by its ID. In case of success, the request will return a response with status 200.

**GET** `/v2/wallet_connect/agreements/{agreement_id}`

## Request parameters

### Header

- `x-platform-id` (string, optional)
  Identifier for platforms or modules that offer Mercado Pago within their solutions.

### Path

- `agreement_id` (string, required)
  Unique identifier of the agreement.

### Query

- `client.id` (number, optional)
  Unique identifier of the client application.

## Response parameters

- `id` (string, optional)
  Unique identifier of the agreement.

- `date_created` (string, optional)
  Date and time the agreement was created, in ISO 8601 format.

- `date_canceled` (string, optional)
  Date and time the agreement was canceled, in ISO 8601 format.

- `date_expire` (string, optional)
  Date and time the agreement expires, in ISO 8601 format.

- `validation_code` (string, optional)
  Authorization code used to generate the payer token.

- `approval_uri` (string, optional)
  URI to redirect the buyer to a previously linked wallet in the frontend.

- `redirect_uri` (string, optional)
  URI the buyer is redirected to after the agreement is complete.

- `status` (string, optional)
  Current status of the agreement.

- `external_flow_id` (string, optional)
  Seller's internal identifier for the current flow state.

- `external_user` (object, optional)
  Data used by the seller to identify the buyer within their own system.

  - `external_user.id` (string, optional)
  Seller's unique identifier for the buyer.

  - `external_user.description` (string, optional)
  Label for the buyer in the seller's system, such as the buyer's name.

- `agreement_data` (object, optional)
  Additional data about the agreement, including optional amount and description.

  - `agreement_data.validation_amount` (number, optional)
  Reference amount for the agreement. If the buyer's account balance is insufficient to cover this amount, a card will be required as a secondary payment method.

  - `agreement_data.description` (string, optional)
  Description of the actions the buyer is about to perform.

- `site_id` (string, optional)
  Country of origin of the Mercado Pago account.

- `application_id` (number, optional)
  Unique identifier of the application.

- `collector_id` (number, optional)
  Mercado Pago user ID of the application owner.

- `model_version` (number, optional)
  Version of the agreement API.

## Errors

| Status | Error | Description |
| ------- | ------- | ----------- |
| 400 | 400 | Bad Request. |
| 404 | 404 | Not Found. |
| 500 | internal_error | Some error occurred on our side while attempting to process the request. Please try again later. |

## Request example

### cURL

```bash
curl -X GET \
  'https://api.mercadopago.com/v2/wallet_connect/agreements/{agreement_id}?client.id=<CLIENT.ID>' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'
```

## Response example

```json
{
  "id": "b1234e5678b91c23a456e78912345b67",
  "date_created": "2023-02-16T00:02:52Z",
  "date_canceled": "2023-02-16T00:02:52Z",
  "date_expire": "2023-02-16T00:02:52Z",
  "validation_code": "790eb6591ff68df74c57930551ed980239f4538a7e530",
  "approval_uri": "https://www.mercadopago.com.ar/v1/wallet_agreement/b1234e5678b91c23a456e78912345b67",
  "redirect_uri": "https://www.mercadopago.com/",
  "status": "confirmed_by_user",
  "external_flow_id": "external_flow_id",
  "external_user": {
  "id": "usertest",
  "description": "Test account"
  },
  "agreement_data": {
  "validation_amount": "24.50",
  "description": "Test agreement"
  },
  "site_id": "MLA",
  "application_id": 123456789,
  "collector_id": 987654,
  "model_version": 2
}
```