# Marvin Labs API > Marvin is an equity research analyst. The API asks it questions (`/v1/responses`), reads its conversations and research reports, and calls its document and financials tools directly. Authenticate with `Authorization: Bearer `; the base URL is in the Quickstart. ## Guides - [Marvin Labs API](https://marvin-labs-api-docs.vercel.app/): What the Marvin Labs API does and where to start. - [Quickstart](https://marvin-labs-api-docs.vercel.app/quickstart/): Create an API key and ask Marvin your first question with curl, Python or TypeScript. - [Authentication](https://marvin-labs-api-docs.vercel.app/guides/authentication/): Bearer API keys, what a key can reach, and how revoking one takes effect. - [Long-running requests](https://marvin-labs-api-docs.vercel.app/guides/long-requests/): Turns and research tools can take minutes. How the API keeps those connections open, and how to set your client up for them. - [Pagination](https://marvin-labs-api-docs.vercel.app/guides/pagination/): How list endpoints page with an opaque cursor. - [Errors](https://marvin-labs-api-docs.vercel.app/guides/errors/): The error envelope, the stable error codes, and which errors are worth retrying. - [Rate limits](https://marvin-labs-api-docs.vercel.app/guides/rate-limits/): Requests per minute per key, the two tiers, and the headers that report them. - [Credits](https://marvin-labs-api-docs.vercel.app/guides/credits/): Which API calls use credits, and what happens when your allowance runs out. ## API reference - [OpenAPI schema](https://marvin-labs-api-docs.vercel.app/openapi.json) - [POST /v1/responses](https://marvin-labs-api-docs.vercel.app/reference/#tag/responses/POST/v1/responses): Ask Marvin a question. - [GET /v1/responses/{response_id}](https://marvin-labs-api-docs.vercel.app/reference/#tag/responses/GET/v1/responses/{response_id}): A response by id: queued, running, or finished with its answer. - [POST /v1/responses/{response_id}/cancel](https://marvin-labs-api-docs.vercel.app/reference/#tag/responses/POST/v1/responses/{response_id}/cancel): Stop a running response. A response still queued behind another is not removed. - [GET /v1/conversations](https://marvin-labs-api-docs.vercel.app/reference/#tag/conversations/GET/v1/conversations): Your conversations, most recently updated first. Includes the ones started in the app. - [GET /v1/conversations/{conversation_id}](https://marvin-labs-api-docs.vercel.app/reference/#tag/conversations/GET/v1/conversations/{conversation_id}): A conversation's title, timestamps and the companies it involves. - [GET /v1/conversations/{conversation_id}/items](https://marvin-labs-api-docs.vercel.app/reference/#tag/conversations/GET/v1/conversations/{conversation_id}/items): The conversation's questions and answers, oldest first. - [GET /v1/agent_results](https://marvin-labs-api-docs.vercel.app/reference/#tag/agent-results/GET/v1/agent_results): Agent results you can read, newest first: yours, ones shared with you, and public ones. - [GET /v1/agent_results/{agent_result_id}](https://marvin-labs-api-docs.vercel.app/reference/#tag/agent-results/GET/v1/agent_results/{agent_result_id}): One agent result with its report in markdown (`output_text`). - [POST /v1/tools/documents/list](https://marvin-labs-api-docs.vercel.app/reference/#tag/tools/POST/v1/tools/documents/list): One company's documents, newest first: filings, Marvin's reports and your uploads. - [POST /v1/tools/documents/search](https://marvin-labs-api-docs.vercel.app/reference/#tag/tools/POST/v1/tools/documents/search): The passages in one company's documents that answer `query`, best first. Uses credits. - [POST /v1/tools/documents/read](https://marvin-labs-api-docs.vercel.app/reference/#tag/tools/POST/v1/tools/documents/read): Read any document you can see, by short or full id: whole, a window, or around a match. - [POST /v1/tools/documents/explore](https://marvin-labs-api-docs.vercel.app/reference/#tag/tools/POST/v1/tools/documents/explore): What one of a company's documents says about `question`, as verbatim passages. Uses credits. - [POST /v1/tools/financials/query](https://marvin-labs-api-docs.vercel.app/reference/#tag/tools/POST/v1/tools/financials/query): Reported figures by metric and period, one result per metric. Uses credits. - [POST /v1/tools/financials/statements](https://marvin-labs-api-docs.vercel.app/reference/#tag/tools/POST/v1/tools/financials/statements): A company's statements whole, every line in order. Without `statement`, the list of them. - [POST /v1/tools/financials/provenance](https://marvin-labs-api-docs.vercel.app/reference/#tag/tools/POST/v1/tools/financials/provenance): Where figures come from: the document and line each was read from, or its inputs. ## Optional - [Changelog](https://marvin-labs-api-docs.vercel.app/changelog/) - [Every guide in one file](https://marvin-labs-api-docs.vercel.app/llms-full.txt)