# Settlement Recovery

Do a recovery if you want to get the settled markets for each fixtures.

Endpoint: ​/v1​/settlement​/recovery\
Method: POST 

Headers:

| Name        | Description                                                     |
| ----------- | --------------------------------------------------------------- |
| x-client-id | A static client id will be assigned to you upon request.        |
| x-api-key   | We will provide you with an api key to be able to call the API. |

The payload request should contain JSON data structured according to the API specifications. Here's an example of a payload request:

```
{
  "sportId": 0,
  "fixtureSpecifier": "string"
}
```

*Note: Client only needs to supply either one of the property. If fixture specifier and sport id is provided, our system would only honor fetching the latest settlement for the fixture specifier*

Properties:

| Name             | Type   | Description                                             |
| ---------------- | ------ | ------------------------------------------------------- |
| sportId          | string | sport id that you want to recover                       |
| fixtureSpecifier | string | specify the specfier of the fixture you want to recover |

Once executed, our system would retrieve the settlement messages for all settled matches in a sport (limited to only sending up to 2 weeks old fixtures) then send those data in the odds feed as  [OnMarketSettlement](/odds-feed-documentation/odds-feed-integration/message-types/onmarketsettlement.md) message.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://flyingcockatoo.gitbook.io/odds-feed-documentation/recovery/settlement-recovery.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.