# CurbWaste

- [How the partner API fits together](https://docs.curbwaste.com/introduction.md): Who the CurbWaste partner API is for, what it covers today, and how API keys, REST, MCP, and webhooks relate.
- [CurbWaste API Authentication: API Keys and Bearer Tokens](https://docs.curbwaste.com/authentication.md): CurbWaste uses company API keys with Bearer token authentication. Learn how to create your key in the Developer Platform, set required scopes, and handle auth errors.
- [CurbWaste API Quickstart: Create Your First Customer Record](https://docs.curbwaste.com/quickstart.md): Make your first CurbWaste API call in under 5 minutes. This guide walks you through authenticating, creating a customer, and verifying the response.
- [Customers](https://docs.curbwaste.com/concepts/customers.md): Understand the Customer as the account hub in CurbWaste — identifiers, profile fields, and how it connects to locations, pricing, and other domains.
- [Webhooks](https://docs.curbwaste.com/concepts/webhooks.md): Understand outbound CurbWaste webhooks — signed HTTPS deliveries, event catalog, and how they differ from REST API keys.
- [MCP](https://docs.curbwaste.com/concepts/mcp.md): Understand CurbWaste MCP — the same company API keys and scopes as REST, exposed as tools for AI agents over Streamable HTTP.
- [Sync customers](https://docs.curbwaste.com/guides/sync-customers.md): Keep your system linked to CurbWaste customers — create, store the UUID join key, update, find with searchTerm, and optionally ingest webhook events.
- [Webhook setup](https://docs.curbwaste.com/guides/webhooks-setup.md): Register your webhook endpoint, verify HMAC signatures, and handle outbound CurbWaste events in your application.
- [Overview](https://docs.curbwaste.com/api-reference/overview.md): Base URL, authentication, versioning, and shared request/response conventions for the CurbWaste partner REST API.
- [Errors](https://docs.curbwaste.com/api-reference/errors.md): HTTP status codes and error body shape for the CurbWaste partner API, including auth, scopes, not-found, and rate limits.
- [Usage](https://docs.curbwaste.com/api-reference/usage.md): Rate limits for the CurbWaste partner API — company request quota for REST and MCP, and what to do when you hit 429.
- [List Pricelists](https://docs.curbwaste.com/api-reference/catalog/list-pricelists.md)
- [Create Customer Pricelist](https://docs.curbwaste.com/api-reference/catalog/create-customer-pricelist.md)
- [List Pricelist Skus](https://docs.curbwaste.com/api-reference/catalog/list-pricelist-skus.md)
- [List Services](https://docs.curbwaste.com/api-reference/catalog/list-services.md)
- [List Skus](https://docs.curbwaste.com/api-reference/catalog/list-skus.md)
- [Get Sku](https://docs.curbwaste.com/api-reference/catalog/get-sku.md)
- [List customers](https://docs.curbwaste.com/api-reference/customers/list-customers.md): List customers.
- [Create customer](https://docs.curbwaste.com/api-reference/customers/create-customer.md): Create customer.
- [Get customer](https://docs.curbwaste.com/api-reference/customers/get-customer.md): Get customer.
- [Update customer](https://docs.curbwaste.com/api-reference/customers/update-customer.md): Update customer.
- [List Locations](https://docs.curbwaste.com/api-reference/locations/list-locations.md)
- [Create Location](https://docs.curbwaste.com/api-reference/locations/create-location.md)
- [Validate Address](https://docs.curbwaste.com/api-reference/locations/validate-address.md)
- [Get Location](https://docs.curbwaste.com/api-reference/locations/get-location.md)
- [Update Location](https://docs.curbwaste.com/api-reference/locations/update-location.md)
- [List Zones](https://docs.curbwaste.com/api-reference/zones/list-zones.md)
- [List Zones By Zip](https://docs.curbwaste.com/api-reference/zones/list-zones-by-zip.md)

## OpenAPI Specs

- [public.openapi](/openapi/public.openapi.json)
- [webhooks.openapi](/openapi/webhooks.openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.