​
Basic Usage

Base URL for all API endpoints: 
https://api.b2d.ai
Authentication:
  • As a header: x-api-key: YOUR_API_KEY
  • As a query parameter: ?api_key=YOUR_API_KEY

​
Error Codes

CodeMessageDescription
200OKSuccessful response
400Bad RequestInvalid input or malformed request
401UnauthorizedAPI key missing
402Payment RequiredInsufficient credits to process request
403ForbiddenInvalid or unauthorized API key
500Internal Server ErrorUnexpected server-side issue

​
Credit System

Each successful request (returns data) consumes credits. Credits vary per endpoint.

​
Endpoint-Specific Credit Pools

Some endpoints have dedicated credit pools:
  • Search operations (/jobs/<job_id>/search): May have separate search credit limits
  • Assessment operations (/jobs/<job_id>/assess): May have separate assess credit limits
  • User lookups (/user): Use general credit pool

​
Credit Verification

Credits are checked before processing your request. If insufficient credits are available:
  • Request returns 402 Payment Required status
  • No data is processed or returned
  • No credits are consumed

​
Response Headers

All successful responses include detailed credit information: Usage Tracking:
  • X-Credits-Used: Total credits used across all endpoints
  • X-Credits-Used-User: Credits used for /user endpoint
  • X-Credits-Used-Search: Credits used for /jobs/search endpoint
  • X-Credits-Used-Assess: Credits used for /jobs/assess endpoint
Remaining Credits:
  • X-Credits-Remaining: General credits remaining (-1 for unlimited)
  • X-Credits-Remaining-Search: Search credits remaining (if configured)
  • X-Credits-Remaining-Assess: Assess credits remaining (if configured)
Call Counters:
  • X-Calls-User: Total calls to /user endpoint
  • X-Calls-Search: Total calls to /jobs/search endpoint
  • X-Calls-Assess: Total calls to /jobs/assess endpoint

​
X-Request-Origin (Optional)

If you pass the X-Request-Origin header in your request, it will be included in the response headers.
This is useful for tracking the origin of your requests (e.g., from a specific frontend app, client ID, or experiment). Example Request: 
GET /user?github_username=torvalds
Host: api.b2d.ai
x-api-key: YOUR_API_KEY
x-request-origin: dashboard-v1
Example Response: 
X-Request-Origin: dashboard-v1

​
API Endpoints

​
User Match Endpoint

Retrieve detailed developer profiles using GitHub, LinkedIn, X (Twitter), or email. Example Request: 
GET https://api.b2d.ai/user?github_username=torvalds&api_key=YOUR_API_KEY
📬 Need Help or Access?
Contact us at henry@b2d.ai