# ID.me document passback API

**Canonical:** https://apis.io/apis/idme/document-passback-api/  
**Provider:** ID.me — https://apis.io/providers/idme/  
**Base URL:** https://api.id.me  
**Documentation:** https://docs.id.me/apis/document-passback-api

ID.me document passback API is one of 6 APIs that [ID.me](https://apis.io/providers/idme/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 3 JSON Schemas.

ID.me document passback API as documented publicly: 3 operations. Contract generated from the documentation by API Evangelist (2026-10-20); not the provider's own document.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/public/v3/attributes.json` | Get document tokens from the attributes endpoint with a valid access token. |
| POST | `/api/public/v3/documents/refresh/{documentToken}` | Generate a new document token without requiring a new user session. |
| POST | `/api/public/v3/documents/{documentToken}` | Retrieve the document image using the document token and API token. |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/idme/refs/heads/main/openapi/_ae-authored/idme-document-passback-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/idme/refs/heads/main/json-schema/idme-get-api-public-v3-attributes-json-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/idme/refs/heads/main/json-schema/idme-post-api-public-v3-documents-refresh-documenttoken-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/idme/refs/heads/main/json-schema/idme-post-api-public-v3-documents-documenttoken-response-schema.json

## Other ID.me APIs (5)

- [ID.me OpenID Connect & OAuth 2.0 API](https://apis.io/apis/idme/id-me-openid-connect-oauth-2-0-api/)
- [ID.me Services API](https://apis.io/apis/idme/id-me-services-api/)
- [ID.me applications API](https://apis.io/apis/idme/applications-api/)
- [ID.me core API](https://apis.io/apis/idme/core-api/)
- [ID.me services API](https://apis.io/apis/idme/services-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/idme/document-passback-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/idme/.