​
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
403ForbiddenInvalid or unauthorized API key
500Internal Server ErrorUnexpected server-side issue

​
Credit System

Each successful request (returns data) consumes credits. Credits vary per endpoint. Successful responses include the following headers:
  • X-Credits-Used: Total number of credits used so far
  • X-Credits-Remaining: Remaining credits (or -1 for unlimited plans)

​
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 /match/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/match/user?github_username=torvalds&api_key=YOUR_API_KEY
📬 Need Help or Access?
Contact us at justin@b2d.ai