GetFilingFiles
GET
https://test.api.neotek.sa/qawaem/v1/get-filing-filesSandbox URL · in Production call https://api.neotek.sa
The documents behind one filing, base64-encoded. A single filing can carry several files — typically the statements as a PDF alongside the XBRL data as XML.
Query parameters:
| Parameter | Required | Description |
|---|---|---|
filingCode | Required | the code of the filing to download, from GetCRDetails |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN>, with scope qawaem_establishment_information |
x-request-id | Optional | an RFC 4122 UUID you generate; quote it when raising a support ticket |
sub-client | Optional | identifies the downstream consumer when one client fronts several |
cURL
curl -G 'https://test.api.neotek.sa/qawaem/v1/get-filing-files' \ -H 'Authorization: Bearer <ACCESS_TOKEN>' \ -d 'filingCode=<filingCode>'Response (FileContent truncated — the real value is the full base64-encoded file)
JSON
{ "Data": [ { "FileName": "FS.pdf", "Extension": ".pdf", "ContentType": "application/pdf", "FileContent": "JVBERi0xLjcNCiW1tbW1DQox..." }, { "FileName": "MCI_7000000001_06Aug2021.xml", "Extension": ".xml", "ContentType": "application/pdf", "FileContent": "PD94bWwgdmVyc2lvbj0iMS4w..." } ]}Errors
| Code | Status | Cause and Action |
|---|---|---|
400 | Bad Request | Required field missing, or a value fails validation — check Code and Path in the body |
401 | Unauthorized | Bearer token missing, expired, or invalid |
403 | Forbidden | Token doesn't carry the qawaem_establishment_information scope |
404 | Not Found | No resource matches the identifier provided |
405 | Method Not Allowed | HTTP verb not supported on that path |
406 | Not Acceptable | Accept header doesn't match a supported representation |
415 | Unsupported Media Type | Content-Type missing or wrong |
429 | Too Many Requests | Rate limit exceeded |
500 | Internal Server Error | Server error |