Get Public File by ID
This endpoint retrieves a publicly accessible file stored on the Netevia platform using its unique integer ID. Public files are accessible to authenticated partners and may include documents such as disclosures, terms, or other shared resources. Use this endpoint to fetch file content or metadata when you have a valid file ID.
Endpoint
GET /Files/public/{id}
Authentication
Bearer token required. Obtain via:
POST https://api.banking.netevia.dev/api/auth/v2Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.
When to use
Use this endpoint when you need to retrieve a public file by its ID, such as fetching a shared document, disclosure, or resource that has been made publicly available on the platform. This is useful when displaying documents to customers or retrieving supporting materials associated with onboarding or compliance workflows. You must have a valid Bearer token to call this endpoint.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer (int32) | Yes | The unique numeric identifier of the public file to retrieve. |
Response
200 OK
Returns the requested public file. The response body contains the file content or binary data associated with the specified ID.
| Field | Type | Description |
|---|---|---|
| (file content) | binary/stream | The raw content of the requested public file. |
{}Note: The response payload is the file content itself (e.g., binary data, PDF, image). The exact content type depends on the file stored under the given ID.
Error Codes
| Code | When it happens |
|---|---|
| 400 | The provided id is not a valid integer or is malformed. |
| 401 | Token missing, expired, or invalid. |
| 403 | Insufficient permissions to access the requested file. |
| 404 | No public file found with the specified ID. |
| 500 | Internal server error. |
Common Mistakes
- Passing a non-integer or negative value for
id— the field must be a valid int32 value. - Omitting the Bearer token or using an expired token, resulting in a 401 response.
- Attempting to access a file ID that belongs to a private (non-public) file, which will return 404 or 403.
Related Endpoints
GET /Files/{id}— Retrieve a private or partner-specific file by ID.POST /Files— Upload a new file to the platform.
Example
curl -X GET https://api.banking.netevia.dev/Files/public/42 \
-H "Authorization: Bearer YOUR_TOKEN"Success