canonical: https://jentic.com/apis/swaggerhub.bluesheets/bluesheets-receipts-ai-api

# Bluesheets receipts AI API

This is a synchronous API that is aimed to extract key data from receipts. Extraction time can vary from 1 second to 5 seconds. If you have any questions or if you need to get access_token, please click “Contact the developer” link underneath. The API exposes 1 endpoints secured with apiKey authentication.

## For AI agents

Programmatically sending files to recognition. Covers 1 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or developer tools - use for crm only.

## Capabilities

- sending files to recognition
- Manage crm data programmatically
- Integrate Bluesheets receipts AI API into automated workflows
- Query and filter Bluesheets receipts AI API records by parameters
- Monitor Bluesheets receipts AI API operational status and events

## Use cases

### CRM Operations

Use the Bluesheets receipts AI API to perform crm operations programmatically. The API provides 1 endpoints covering core functionality including sending files to recognition.

Example prompt: Call POST /documents/extractSync to sending files to recognition

### Data Retrieval and Monitoring

Query Bluesheets receipts AI API resources on a schedule to track changes, generate alerts, or feed downstream dashboards. Agents poll relevant endpoints, compare against previous state, and trigger actions when thresholds are crossed.

Example prompt: Poll the primary Bluesheets receipts AI API endpoint, compare response to last known state, and alert if changed

### AI Agent Integration via Jentic

AI agents discover and call Bluesheets receipts AI API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'sending files to recognition', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /documents/extractSync | sending files to recognition |

## Key resources

- **documents** — Operations related to documents

## Why Jentic

- **Setup:** Wiring the Bluesheets receipts AI API by hand means learning its access_token query-key auth, targeting the app.bluesheets.io backend, and handling the synchronous extraction call and its retries yourself. Through Jentic you install once, import the Bluesheets receipts AI API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Requests target the extraction operation through the request body rather than a resource id in the URL path, so scope the agent to the operations it needs, such as synchronous document extraction with POST /documents/extractSync. The agent runs only the operations you allow.
- **Credential handling:** Your Bluesheets access token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'extract data from a receipt', and Jentic returns the matching Bluesheets operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Hubspot** — Alternative crm API
- **Salesforce** — Alternative crm API
- **Pipedrive** — Complementary crm API
- **Zoho** — Complementary crm API

## FAQ

### What authentication does the Bluesheets receipts AI API use?

The Bluesheets receipts AI API uses an API key passed in the `access_token` query. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I sending files to recognition with the Bluesheets receipts AI API?

Yes. Use the POST /documents/extractSync endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Bluesheets receipts AI API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I sending files to recognition through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'sending files to recognition'. Jentic returns the matching Bluesheets receipts AI API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Bluesheets receipts AI API have?

The Bluesheets receipts AI API exposes 1 endpoints covering documents operations.

### Can I limit what my agent is allowed to do with the Bluesheets receipts AI API?

Yes. Because Jentic One is self-hosted, you set the rules that decide which Bluesheets operations and credentials your agent may use. This API exposes a single operation, POST /documents/extractSync for synchronous receipt extraction, so you scope the agent to only that call and it can do nothing else against Bluesheets. Your stored access token is injected at execution time only for the operations you permit.