Source Attribution

The X-Source header allows you to identify your domain when making requests to PassingRight. This information is used to generate public usage statistics showing how PassingRight is being used across different websites and applications.

X-Source Header

Include the X-Source header with your domain name in your requests:

curl -X POST https://api.passingright.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LLM_GATEWAY_API_KEY" \
  -H "X-Source: example.com" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'

Domain Format

The X-Source header accepts domain names in various formats. All of the following are valid and will be normalized to the same domain:

• example.com
• https://example.com
• https://www.example.com
• www.example.com

All variations will be stripped down to the base domain (example.com) for aggregation purposes.

After stripping the protocol and www. prefix, the value must contain only alphanumeric characters, hyphens, dots, and slashes — a value with other characters (underscores, spaces, query strings) fails the whole request with a 400.

When no X-Source header is sent, the gateway falls back to the HTTP-Referer header, and recognizes well-known coding agents from the User-Agent header for source attribution.

Public Statistics

Data from the X-Source header is used to generate public statistics about PassingRight usage, including:

• Popular Domains: Which websites and applications are using PassingRight most frequently
• Model Usage: What models are being used by different domains
• Geographic Distribution: Where requests are coming from across different sources
• Growth Trends: How usage is growing over time for different domains

These statistics help demonstrate the adoption and impact of PassingRight across the ecosystem.

Privacy Considerations

What's Public

• Domain names (stripped of protocol and www prefixes)
• Aggregated request counts and model usage
• General geographic regions (country-level data)

What's Private

• Individual request content or responses
• User identifiers or personal information
• Detailed usage patterns beyond aggregated counts
• API keys or authentication details

Benefits

Including the X-Source header provides several benefits:

For Your Project

• Recognition: Your domain will appear in public usage statistics
• Credibility: Demonstrates real-world usage of your application
• Community: Contributes to the broader PassingRight ecosystem

For the Community

• Transparency: Shows real adoption and usage patterns
• Inspiration: Other developers can see successful implementations
• Growth: Helps demonstrate the value of open-source LLM infrastructure

Optional but Recommended

While the X-Source header is optional, we strongly encourage its use to:

• Support transparency in the PassingRight ecosystem
• Help showcase successful integrations
• Contribute to understanding of LLM usage patterns
• Demonstrate the real-world impact of your application

Your participation helps build a more transparent and collaborative LLM ecosystem.