Skip to main content
Welcome to the Pretectum API Reference. This documentation provides everything you need to integrate with the Pretectum platform and access your master data programmatically.

​
Base URL

All API requests should be made to: 
https://api.pretectum.io

​
Authentication

The Pretectum API uses token-based authentication. Before making API requests, you need to obtain an access token using your client credentials.

Get Access Token

Learn how to authenticate and obtain an access token

​
How Authentication Works

  1. Obtain Credentials: Contact your Pretectum tenant administrator to receive your client_id and client_secret.
  2. Request Token: Use the Token endpoint to exchange your credentials for an access token.
  3. Include Token: Add the access token to the Authorization header of your API requests.
The access token should be passed directly in the Authorization header without the “Bearer” prefix. This is not a standard Bearer token.

​
Available Endpoints

Token

Obtain an access token for API authentication

Search Data Objects

Search across your master data objects

​
Rate Limiting

API requests are subject to rate limiting. If you exceed the rate limit, you will receive a 429 Too Many Requests response. Please implement appropriate retry logic with exponential backoff.

​
Error Handling

The API returns standard HTTP status codes to indicate success or failure:
Status CodeDescription
200Success
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing token
403Forbidden - Insufficient permissions
404Not Found - Resource does not exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error

​
Need Help?

If you have questions or need assistance, contact our support team at [email protected].