Skip to main content

Authentication

The Petrominds API uses API keys to authenticate requests. Your API key carries privileges to access our engineering calculation services, so be sure to keep it secure. Do not share your API key in publicly accessible areas such as GitHub, client-side code, or public repositories.

Base URLs

Each Petrominds service has its own base URL. You can find the specific base URL in the documentation for each service:

API Key Usage

All API requests must include your API key in the x-api-key header:

POST /endpoint HTTP/1.1
Host: api.petrominds.com
Content-Type: application/json
x-api-key: YOUR_API_KEY

Requests without a valid API key will return a 401 Unauthorized error. See Errors for detailed error response formats.

Obtaining an API Key

To obtain an API key for the Petrominds API:

  1. Contact our team at contact@petrominds.com
  2. Select your plan based on your expected API usage
  3. Receive your API key via secure email delivery
  4. Start integrating using our comprehensive documentation

Our team will work with you to understand your requirements and recommend the appropriate plan for your use case.

Rate Limits

API requests are limited to 60 requests per minute per API key. If you exceed this limit, requests will return a 429 Too Many Requests error.

For higher rate limits, contact us at contact@petrominds.com to discuss enterprise options.