# List a deal's offers

Every offer on one deal, side by side and best first, with the figures the desk compares them on. The POST on this same path BUILDS offers; this GET compares what is on the ladder. If the offers page has lost its deal relation column the call says so rather than answering 'no offers', which would be a claim about the deal. Deals page only.

Access class: `def:read`.

## Endpoint

`GET /v1/definitions/{key}/rows/{rowId}/offers`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| key | path | string | Yes |
| rowId | path | string | Yes |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "best": {
      "apr": 1.5,
      "buyRate": 1.5,
      "comparisonScore": 1.5,
      "costOfCapital": 1.5,
      "factorRate": 1.5,
      "feePercentage": 1.5,
      "fundedAmount": 1.5,
      "isBestOffer": true,
      "lender": "string",
      "netFunding": 1.5,
      "offer": "string",
      "paymentAmount": 1.5,
      "productType": "string",
      "rowId": "",
      "status": "string",
      "submissionShareId": "",
      "termDays": 1,
      "totalFees": 1.5,
      "totalPayback": 1.5,
      "version": "string"
    },
    "count": 1,
    "dealRowId": "",
    "offers": [
      {
        "apr": "string",
        "buyRate": "string",
        "comparisonScore": "string",
        "costOfCapital": "string",
        "factorRate": "string",
        "feePercentage": "string",
        "fundedAmount": "string",
        "isBestOffer": "string",
        "lender": "string",
        "netFunding": "string",
        "offer": "string",
        "paymentAmount": "string",
        "productType": "string",
        "rowId": "",
        "status": "string",
        "submissionShareId": "",
        "termDays": "string",
        "totalFees": "string",
        "totalPayback": "string",
        "version": "string"
      }
    ]
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
