Overview

Review the PartsSource Customer API documentation before getting started.

The Customer API is designed for external integrations with the PartsSource Marketplace Platform. It enables partners and customers to programmatically search the parts catalog, place orders, and manage user information within their authorized tenant.

Base URL

https://api.partssource.com/customer

Key Features

Multi-Tenant Architecture

The Customer API enforces strict tenant isolation. Each request is scoped to your organization, ensuring you can only access data belonging to your authorized tenant. Attempts to access resources outside your tenant will return a 403 Forbidden error.

Available Resources

Resource	Description
Catalog	Search parts and retrieve detailed product information including pricing options
Orders	Create new orders and retrieve order status and details
Users	Look up user profiles and search users within your organization

Authentication

All API requests require a valid JWT Bearer token obtained via AWS Cognito OAuth 2.0 client credentials flow.

curl -X POST https://auth.partssource.com/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "scope=default-m2m-resource-server-p2hkah/customer:read"

Include the token in all requests:

curl -X GET https://api.partssource.com/customer/users/lookup?userId=12345 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

For complete authentication details, see Authentication Overview.

Response Format

All responses follow a consistent wrapper format:

{
  "success": true,
  "data": { ... },
  "errors": null,
  "correlationId": "abc123-def456",
  "timestamp": "2025-01-10T12:00:00Z"
}

Field	Description
success	Indicates if the request completed successfully
data	The response payload (varies by endpoint)
errors	Array of error messages if success is false
correlationId	Unique identifier for request tracing and support
timestamp	UTC timestamp of the response

Getting Started

1. Request API credentials - Contact PartsSource to obtain your client ID and secret

2. Review authentication - Understand the OAuth 2.0 flow

3. Explore the API Reference - Browse available endpoints and schemas below

4. Test in your environment - Start with catalog search before placing orders

Support

For API support, contact [email protected]. Include the correlationId from error responses for faster troubleshooting.