Skip to main content

​
Base URL

https://api.buildwithtrace.com/api/v2/

​
Authentication

All authenticated endpoints require a JWT Bearer token in the Authorization header: 
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.buildwithtrace.com/api/v2/user/profile
Get your token by logging in via the API or from the Trace app (Settings → API Token).

​
API Sections

Authentication

Login, signup, OAuth, and token management.

Chat & AI

Stream AI responses for circuit design assistance.

User

Profile, statistics, quota, and activity.

Schematic

Version control for schematic files.

PCB

PCB layout operations and autorouting.

Downloads

Download Trace application releases.

​
Quick Example

curl -X GET "https://api.buildwithtrace.com/api/v2/user/profile" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

​
Rate Limiting

API responses include rate limit headers:
HeaderDescription
X-RateLimit-LimitMaximum requests per window
X-RateLimit-RemainingRemaining requests in window
X-RateLimit-ResetSeconds until window resets

​
Plan Restrictions

PlanChat ModesAPI Access
FreeAsk onlyRead-only
TrialAsk, Agent, PlanFull
ProAsk, Agent, PlanFull
UltraAsk, Agent, PlanFull

​
Error Responses

All errors follow a standard format: 
{
  "error": "Error message describing what went wrong",
  "status_code": 400
}
Status CodeDescription
400Bad request
401Unauthorized
402Quota exceeded
403Forbidden (plan limit)
404Not found
429Rate limit exceeded
500Internal server error