Skip to main content

​
United Logistics API

Welcome to the United Logistics API documentation. This API allows you to programmatically manage fuel entries, products, and vendors for your fleet.
This API uses REST principles and returns JSON responses. All requests require authentication using an API key.

​
Getting Started

To get started with the United Logistics API:
  1. Generate an API Key: Navigate to Settings in your dashboard to generate your API key
  2. Authenticate: Include your API key in the X-API-Key header of all requests
  3. Make Requests: Use the documented endpoints to manage your fuel data

​
Base URL

All API requests should be made to: 
https://unitedpetroleum.app/api

​
Authentication

All API requests must include your API key in the request headers: 
X-API-Key: your_api_key_here
Keep your API key secure and never share it publicly. Treat it like a password.

​
Rate Limiting

API requests are rate-limited to:
  • 100 requests per minute per API key
  • 1,000 requests per hour per API key
If you exceed these limits, you’ll receive a 429 Too Many Requests response.

​
Response Format

All responses are returned in JSON format with the following structure:

​
Success Response

{
  "data": { ... },
  "status": 200
}

​
Error Response

{
  "error": "Error message here",
  "status": 400
}

​
Common HTTP Status Codes

Status CodeDescription
200Success
201Created
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
403Forbidden - Insufficient permissions
404Not Found
429Too Many Requests - Rate limit exceeded
500Internal Server Error

​
Available Endpoints

Fuel Entries API

Create, read, update, and delete fuel entry records

​
Support

For API support or questions, contact: sfuentes@solidarityagents.com