API Documentation

Integrate with our services using our comprehensive REST API. Access recycler directories, submit quotes, and manage facility data programmatically.

Getting Started

1. Authentication

All API requests require authentication using an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

2. Base URL

All API endpoints are available at:

https://api.ibctote.org/v1/

3. Rate Limits

API requests are limited to 1000 requests per hour per API key. Rate limit information is included in response headers.

Need an API Key?

API access is available to organization members. Contact our team to request API credentials and discuss your integration requirements.

API Endpoints

Complete reference for all available API endpoints

GET/api/v1/recyclers

Get list of recycling facilities

Parameters

• location
• services
• radius

Response

Array of recycler objects with contact and service information

GET/api/v1/recyclers/{id}

Get detailed information about a specific recycler

Parameters

• id (required)

Response

Detailed recycler object with full facility information

POST/api/v1/quotes

Submit a quote request to multiple recyclers

Parameters

• location
• quantity
• container_type
• services

Response

Quote request ID and estimated response time

GET/api/v1/quotes/{id}

Check status of quote request

Parameters

• id (required)

Response

Quote status and any received responses

Code Examples

Sample code in popular programming languages

JavaScript

// Get recyclers near a location
const response = await fetch('/api/v1/recyclers?location=houston,tx&radius=50', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const recyclers = await response.json();
console.log(recyclers);

Python

import requests

# Get recyclers near a location
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.get('/api/v1/recyclers?location=houston,tx&radius=50', 
                       headers=headers)
recyclers = response.json()
print(recyclers)

cURL

# Get recyclers near a location
curl -X GET "https://api.ibctote.org/v1/recyclers?location=houston,tx&radius=50" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json"

SDKs & Libraries

Official and community-maintained libraries for popular platforms

JavaScript SDK

Official JavaScript library for web and Node.js applications

Python SDK

Official Python library with comprehensive API coverage

PHP

PHP SDK

Community-maintained PHP library for web applications

Need Help with Integration?

Our technical team is available to help with API integration, troubleshooting, and custom development needs.

Contact Technical Support View Documentation