Listings API Documentation

Getting an Access Token

Register a new account or login to receive an access token:

POST /auth/tokens
{
  "email": "[email protected]",
  "password": "your-password"
}

Response:
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "abc123...",
  "user": { ... }
}

Using the Access Token

Include the token in the Authorization header:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token Refresh

Access tokens expire after 1 hour. Use the refresh token to get a new access token:

POST /auth/tokens/refresh
{
  "refresh_token": "abc123..."
}

cURL

curl -H "Authorization: Bearer YOUR_TOKEN" https://listingsapi.globalresolution.net/listings

JavaScript (fetch)

const response = await fetch('https://listingsapi.globalresolution.net/listings', {
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
});
const data = await response.json();

Python (requests)

import requests
headers = {'Authorization': 'Bearer YOUR_TOKEN'}
response = requests.get('https://listingsapi.globalresolution.net/listings', headers=headers)
data = response.json()

Listing Object

{
  "id": "string (UUID)",
  "title": "string",
  "description": "string",
  "price": "number",
  "currency": "string",
  "status": "active | inactive | sold",
  "created_at": "ISO 8601 timestamp",
  "updated_at": "ISO 8601 timestamp"
}

User Object

{
  "id": "string (UUID)",
  "uuid": "string (UUID)",
  "email": "string",
  "role": "admin | seller | buyer",
  "status": "active | inactive",
  "created_at": "ISO 8601 timestamp"
}

Terms of Use

• API access is subject to rate limiting
• Do not abuse the API or attempt to circumvent security measures
• Respect user privacy and data protection regulations
• API keys/tokens must be kept secure

Data Usage

• Data retrieved from the API is for your application use only
• Do not cache or redistribute data without authorization
• Comply with applicable data protection laws (GDPR, CCPA, etc.)