> For the complete documentation index, see [llms.txt](https://help.recart.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.recart.com/developers/public-api/optin-tool/receive-a-single-a-b-test-experiment.md).

# Receive a single A/B test experiment

Get A/B test experiment by ID. An experiment belonging to another site is not visible and returns 404.

```json
{"openapi":"3.1.0","info":{"title":"Recart API","version":"2023-12"},"tags":[{"name":"OptinTool","description":"Opt-in tools"}],"servers":[{"url":"https://api.recart.com/app-integrations/2023-12","description":"Production"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Recart-API-Key","description":"It can be obtained in Recart account after contacting Support"}},"schemas":{"OptinToolExperiment":{"type":["object"],"required":["type","attributes"],"properties":{"type":{"type":"string","enum":["optin-tool-experiments"]},"attributes":{"type":"object","required":["id","name","status","dateFrom","dateTo","optinToolIds","createdAt","updatedAt"],"properties":{"id":{"type":"string","description":"ID of the experiment"},"name":{"type":"string","description":"Name of the experiment"},"status":{"type":"string","description":"Status of the experiment. A scheduled experiment has no\nstatistics yet, so its views return 400.\n","enum":["scheduled","running","ended"]},"dateFrom":{"type":"string","format":"date-time","description":"Start of the experiment window. UTC date and time in ISO 8601 format"},"dateTo":{"type":"string","format":"date-time","description":"End of the experiment window, exclusive. UTC date and time in\nISO 8601 format. For a running experiment this is the planned\nend; statistics stop at the current time instead.\n"},"optinToolIds":{"type":"array","description":"IDs of the opt-in tools taking part in the experiment — its\nvariants. Statistics views return one entry per ID.\n","items":{"type":"string"}},"winnerOptinToolId":{"type":"string","description":"ID of the variant Recart picked as the winner, present once the\nexperiment has ended. Picked on opt-in rate alone — this is not\na statistical significance test.\n"},"winnerOptinRate":{"type":"number","description":"Opt-in rate of the winning variant"},"createdAt":{"type":"string","format":"date-time","description":"Creation time of the experiment. UTC date and time in ISO 8601 format"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification time of the experiment. UTC date and time in ISO 8601 format"}}}}},"HttpErrorBody":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"type":"object","required":["id","code","title","detail"],"properties":{"id":{"type":"string"},"code":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"}}}}}}},"responses":{"HttpError":{"description":"HTTP Error response","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/HttpErrorBody"}}}}}},"paths":{"/optin-tool-experiments/{id}":{"get":{"summary":"Receive a single A/B test experiment","tags":["OptinTool"],"operationId":"getOptinToolExperiment","description":"Get A/B test experiment by ID. An experiment belonging to another site\nis not visible and returns 404.\n","parameters":[{"name":"id","in":"path","required":true,"description":"ID of the experiment","schema":{"type":"string"}}],"responses":{"200":{"description":"Ok","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/OptinToolExperiment"}}}}}},"4XX":{"$ref":"#/components/responses/HttpError"},"5XX":{"$ref":"#/components/responses/HttpError"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.recart.com/developers/public-api/optin-tool/receive-a-single-a-b-test-experiment.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.