# ROOK API

> ROOK API on Apizie: 20 endpoints ([User][Data Sources][Authorizers], [User][Data Sources][Authorized], [User][Info], [User][Data Sources][Revoke], …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/security:rook/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `security:rook`
- Category: Security
- Status: byok
- Source: https://www.tryrook.io
- Page: https://apizie.tech/api/security/rook
- OpenAPI: https://apizie.tech/api/security/rook/openapi.json

### Intro [ROOK](https://docs.tryrook.io/docs/Definitions#rook) is a set of services that simplifies the collection, processing, and delivering of [Users'](https://docs.tryrook.io/docs/Definitions#User)…

## Endpoints

### [User][Data Sources][Authorizers]
`GET https://apizie.tech/v1/security:rook/user-get-data-sources-authorizers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| client_uuid | string | yes | A unique identifier for each client, in UUID4 format. Provided by ROOK upon signing service agreements. |
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| redirect_url | string | no | (Optional): Designates a custom URL to which the user is redirected after a successful authentication or linking process. In its absence,… |

### [User][Data Sources][Authorized]
`GET https://apizie.tech/v1/security:rook/user-get-authorized-data-sources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |

### [User][Info]
`GET https://apizie.tech/v1/security:rook/user-get-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [User][Data Sources][Revoke]
`POST https://apizie.tech/v1/security:rook/user-revoke-auth-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| body | object | yes | JSON request body |

### [Physical][Summary]
`GET https://apizie.tech/v1/security:rook/physical-health-summary-get-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Physical][Events][Activity]
`GET https://apizie.tech/v1/security:rook/health-get-activity-event-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Physical][Events][Heart Rate]
`GET https://apizie.tech/v1/security:rook/health-get-heart-rate-event-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Physical][Events][Oxygenation]
`GET https://apizie.tech/v1/security:rook/health-get-oxygenation-event-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Physical][Events][Stress]
`GET https://apizie.tech/v1/security:rook/health-get-stress-event-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Sleep][Summary]
`GET https://apizie.tech/v1/security:rook/sleep-health-summary-get-summary-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Summary]
`GET https://apizie.tech/v1/security:rook/health-get-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Events][Body Metrics]
`GET https://apizie.tech/v1/security:rook/health-get-body-metrics-event-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Events][Heart Rate]
`GET https://apizie.tech/v1/security:rook/health-get-heart-rate-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Events][Oxygenation]
`GET https://apizie.tech/v1/security:rook/health-get-oxygenation-event-data-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Events][Nutrition]
`GET https://apizie.tech/v1/security:rook/nutrition-get-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Events][Mood]
`GET https://apizie.tech/v1/security:rook/mood-event-data-retrieve` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Events][Hydration]
`GET https://apizie.tech/v1/security:rook/hydration-get-event-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Events][Blood Glucose]
`GET https://apizie.tech/v1/security:rook/health-get-blood-glucose-event-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Events][Blood Pressure]
`GET https://apizie.tech/v1/security:rook/health-get-blood-pressure-event-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

### [Body][Events][Temperature]
`GET https://apizie.tech/v1/security:rook/health-get-temperature-event-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | Unique identifier for the user. Can include numerals, UUID4, strings, or other identifiers. Length must be between 1 to 50 characters. |
| date | string | yes | Date in YYYY-MM-DD format. |

## Example
```
curl "https://apizie.tech/v1/security:rook/user-get-data-sources-authorizers" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the ROOK API?
Create a free Apizie key, then send GET https://apizie.tech/v1/security:rook/user-get-data-sources-authorizers with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the ROOK API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. ROOK itself also needs your own key from api.rook-connect.com.

### Can AI agents use the ROOK API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key security:rook.

### What is the status of the ROOK API?
Needs your own provider key (bring your own key)