v1 · Identifiers API
UUID API
Generate standards-based UUID values instantly.
Create UUID4 identifiers for records, fixtures, prototypes, and distributed applications.
UUIDs are foundational identifiers for records, fixtures, distributed jobs, imports, and prototypes. This API provides standards-based UUID4 values through a simple HTTP contract, making it easy for any backend, script, or low-code workflow to request identifiers without depending on a language-specific package.
Paid capacity is useful when identifier generation belongs to a larger automated workflow and must remain observable and consistent. Teams receive predictable JSON, explicit limits, usage history, and a reusable key instead of maintaining another internal microservice.
THE INTEGRATION CONTRACT
Everything behaves the way a developer expects.
UUID API uses a small HTTP surface, header-based authentication, documented inputs, structured JSON responses, explicit status codes, and usage information returned with successful requests.
- Method and endpoint
- GET /api/v1/uuid/generate/
Send parameters in the query string when the API supports them. No client library or proprietary SDK is required.
- Authentication
- X-API-Key request header
Keys are scoped to one API product. Store the key server-side and include it with every API and balance request.
- Successful response
- HTTP 200 · application/json
The response contains the generated result and
credits_remaining, allowing the calling application to monitor usage. - Usage accounting
- 1 credit per successful request
Invalid, unauthorized, unavailable, and rate-limited calls do not deduct credits. Balance checks are always free.
REQUEST LIFECYCLE
From key to response in four predictable steps.
- 01Validate access
CodeCobra hashes the supplied key and confirms that it belongs to this API and has not been revoked.
- 02Check limits
The service evaluates the key’s per-minute and daily request windows before consuming usage.
- 03Run the API
The documented parameters are validated and the API produces its result through the published endpoint.
- 04Record usage
A successful call is logged, credits are deducted atomically, and the remaining balance is returned.
BUILT FOR REAL APPLICATIONS
Simple does not mean vague.
Authentication failures, exhausted balances, rate limits, and maintenance states each use a distinct HTTP status and machine-readable error code. Your application can decide whether to correct a request, add credits, retry later, or alert an operator.
The same key works for API calls, balance checks, and future credit purchases. There is no account session or SDK state to synchronize.