# Get agreement

This endpoint allows returning information on an existing agreement 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

### Path

- `agreement_id` (string, required)
  Unique identifier of the agreement, returned in the response from the endpoint [/v2/wallet_connect/agreements](/developers/en/reference/online-payments/wallet-connect/orders/create-agreement/post).

## 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_cancelled` (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` through the endpoint [/v2/wallet_connect/agreements/{agreement_id}/payer_token](/developers/en/reference/online-payments/wallet-connect/orders/generate-payer-token/post).

- `agreement_code` (string, optional)
  Agreement code used to generate the `payer_token` through the endpoint [/v2/wallet_connect/agreements/{agreement_id}/payer_token](/developers/en/reference/online-payments/wallet-connect/orders/generate-payer-token/post).

- `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.
Possible enum values:

  - `CREATED`
  The agreement was created and is waiting for the buyer to confirm.

  - `WAITING_USER_CONFIRMATION`
  The agreement is waiting for the buyer to complete the confirmation flow.

  - `WAITING_SELLER_CONFIRMATION`
  The buyer has approved the agreement, which is waiting for the seller to complete the confirmation.

  - `CONFIRMED_BY_USER`
  The buyer has confirmed the agreement. A `payer_token` can now be generated through the endpoint [/v2/wallet_connect/agreements/{agreement_id}/payer_token](/developers/en/reference/online-payments/wallet-connect/orders/generate-payer-token/post).

  - `CONFIRMED`
  The agreement is fully confirmed and a `payer_token` has been generated.

  - `CANCELLED`
  The agreement has been canceled.

  - `DISMISSED`
  The agreement was dismissed without being confirmed by the buyer.

- `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 | invalid_path_param | The `agreement_id` provided in the path is not valid. Please confirm it and provide a valid `agreement_id` to try again. |
| 403 | forbidden | You don't have permission to access the requested resource. Check whether the Access Token used has the permissions and scopes required for this operation. |
| 404 | AgreementNotFound | No agreement was found with the provided ID. This same response is returned when the agreement belongs to another application (`ClientNotOwner`), in order to avoid exposing the existence of other customers' agreements. |
| 404 | ClientNotOwner | The agreement exists but was not created by the current application. The same `AgreementNotFound` response will be returned to avoid exposing the existence of other customers' agreements. |
| 500 | internal_error | An internal server error occurred. Please try again later. If the problem persists, contact support and provide the `x-request-id` and details about the operation performed. |

## Request example

### cURL

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

## Response example

```json
{
  "id": "b1234e5678b91c23a456e78912345b67",
  "date_created": "2023-02-16T00:02:52Z",
  "date_cancelled": "2023-02-16T00:02:52Z",
  "date_expire": "2023-02-16T00:02:52Z",
  "validation_code": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "agreement_code": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "approval_uri": "https://www.mercadopago.com.pe/wallet-connect/vinculation/onboarding?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": "MPE",
  "application_id": 123456789,
  "collector_id": 987654,
  "model_version": 2
}
```