Skip to main content
GET
/
extractions
/
documents
/
{documentId}
Get Document
curl --request GET \
  --url https://api.raydocs.com/extractions/documents/{documentId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workspace_id": 123,
  "filename": "<string>",
  "mime": "<string>",
  "size": 123,
  "sha256": "<string>",
  "status": "uploaded",
  "source_type": "upload",
  "source_url": "<string>",
  "parsings": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "config_hash": "<string>",
      "status": "queued",
      "parser_version": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z"
}

​
Authentication & Scope

Requires the sessions-read ability.

​
Request

GET /extractions/documents/880e8400-e29b-41d4-a716-446655440000 HTTP/1.1
Host: api.raydocs.com
Authorization: Bearer <token>

​
Path Parameters

ParameterTypeRequiredDescription
documentIduuidYesThe document ID

​
Response

200 OK – Document details. 
{
  "id": "880e8400-e29b-41d4-a716-446655440000",
  "workspace_id": 42,
  "filename": "invoice_001.pdf",
  "status": "processed",
  "meta": {
    "page_count": 2,
    "file_size": 125000
  },
  "created_at": "2024-01-15T10:30:00Z"
}
404 Not Found – Document does not exist or you don’t have access.

Authorizations

​
Authorization
string
header
required

Personal Access Token created from the Raydocs dashboard. Include in the Authorization header: Bearer <your_token> See API Keys for token creation and management.

Path Parameters

​
documentId
string<uuid>
required

Response

Successful

​
id
string<uuid>
​
workspace_id
integer
​
filename
string
​
mime
string
​
size
integer

File size in bytes

​
sha256
string
Required string length: 64
​
status
enum<string>
Available options:
uploaded,
queued,
parsing,
parsed,
processed,
failed
​
source_type
enum<string>
Available options:
upload,
url,
connector
​
source_url
string | null
​
parsings
object[]
​
created_at
string<date-time>