Skip to main content
Complete reference for all UUID Generator API endpoints, parameters, and response formats.

​
Base URL

https://api.sinaty.business/uuid/

​
Endpoints Overview

MethodEndpointDescription
GET/uuid/Generate UUIDs with query parameters
POST/uuid/Generate UUIDs with JSON body

​
GET /uuid/

Generate UUID v4 identifiers using query parameters.

​
Query Parameters

ParameterTypeDefaultDescription
countinteger1Number of UUIDs to generate (1-1000)
formatstringstandardOutput format
securebooleanfalseUse cryptographically secure random
uppercasebooleanfalseConvert to uppercase

​
Format Options

FormatDescriptionExample
standardStandard UUID format with hyphens550e8400-e29b-41d4-a716-446655440000
compactWithout hyphens550e8400e29b41d4a716446655440000
bracedWith curly braces{550e8400-e29b-41d4-a716-446655440000}
urnURN formaturn:uuid:550e8400-e29b-41d4-a716-446655440000
base64Base64 encodedVQ6EAOKbQdSnFkRmVUAAA
hexHexadecimal550e8400e29b41d4a716446655440000

​
Example Request

curl "https://api.sinaty.business/uuid/?count=3&format=compact&secure=true"

​
Response Format

{
    "uuids": [
        "550e8400e29b41d4a716446655440000",
        "6ba7b8109dad11d180b400c04fd430c8",
        "6ba7b8119dad11d180b400c04fd430c8"
    ],
    "count": 3,
    "format": "compact",
    "secure": true,
    "uppercase": false,
    "timestamp": "2024-01-15 10:30:00",
    "version": "4",
    "variant": "RFC 4122"
}

​
POST /uuid/

Generate UUIDs using JSON body parameters.

​
Request Body

{
    "count": 5,
    "format": "standard",
    "secure": true,
    "uppercase": false
}

​
Example Request

curl -X POST "https://api.sinaty.business/uuid/" \
  -H "Content-Type: application/json" \
  -d '{"count": 3, "format": "compact", "secure": true}'

​
Response Fields

FieldTypeDescription
uuidsarrayArray of generated UUID strings
countintegerNumber of UUIDs generated
formatstringFormat used for generation
securebooleanWhether secure random was used
uppercasebooleanWhether output was converted to uppercase
timestampstringGeneration timestamp
versionstringUUID version (always “4”)
variantstringUUID variant (always “RFC 4122”)

​
Error Responses

​
Invalid Count (400)

{
    "error": "Count must be between 1 and 1000",
    "details": "Requested count: 1500"
}

​
Invalid Format (400)

{
    "error": "Invalid format specified",
    "details": "Supported formats: standard, compact, braced, urn, base64, hex"
}

​
Invalid Parameter Type (400)

{
    "error": "Invalid parameter type",
    "details": "Parameter 'count' must be an integer"
}

​
HTTP Status Codes

CodeDescription
200Success - UUIDs generated
400Bad Request - Invalid parameters
500Internal Server Error

​
Rate Limits

No rate limits! You can make unlimited requests to our API.

​
Security Considerations

​
Secure vs Standard Random

  • Standard Random: Uses pseudo-random number generator (faster)
  • Secure Random: Uses cryptographically secure random (slower but more secure)
Use secure random for:
  • Security-critical applications
  • Session tokens
  • Cryptographic keys
  • Financial transactions
Use standard random for:
  • Development and testing
  • Non-security-critical applications
  • Performance-sensitive operations

​
Best Practices

​
Bulk Generation

For generating multiple UUIDs, use the count parameter instead of multiple API calls: 
# Good - Single request
curl "https://api.sinaty.business/uuid/?count=100"

# Avoid - Multiple requests
for i in {1..100}; do curl "https://api.sinaty.business/uuid/"; done

​
Format Selection

Choose the appropriate format for your use case:
  • Database Storage: Use compact to save space
  • API Responses: Use standard for readability
  • URIs: Use urn format
  • Binary Storage: Use base64 or hex

​
Error Handling

Always implement proper error handling: 
try {
    const response = await fetch('https://api.sinaty.business/uuid/?count=5');
    if (!response.ok) {
        const error = await response.json();
        console.error('API Error:', error.error);
        return;
    }
    const data = await response.json();
    console.log('Generated UUIDs:', data.uuids);
} catch (error) {
    console.error('Request failed:', error);
}