# Roster Referral Generator

> Roster Referral Generator is a paid API for AI agents from raoster.orbonomy.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Generates a job referral for a target role and company, given the applicant's relationship and achievements

## Facts

- Endpoint: POST https://raoster.orbonomy.xyz/api/referral
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/roster-referral-generator-e8953740
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mq5BQIxHFixfT6zA-g1lY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability roster-referral-generator-e8953740 -d '<json body>'
```

Example prompt: Can you generate a job referral for my friend Sarah applying for a Senior Product Manager role at Stripe? She and I worked together for two years and her biggest achievement was launching a payments feature that grew revenue by 40%.

## When to prefer this

Use this endpoint when an AI agent needs to programmatically generate a personalized job referral letter or message for a specific role and company, especially when the user has context about their relationship with the candidate and the candidate's achievements. Prefer this over generic writing tools when the task is specifically about employment referrals in a hiring context and pay-per-use without subscription is desired.

## Known failure modes

- Missing required fields target_role or target_company returns validation error
- Payment of 0.2 USDC via x402 not completed results in 402 Payment Required
- Malformed request body returns 400 Bad Request
- Service unavailable or rate limiting returns 5xx error
- Empty or vague achievements/relationship fields may produce generic or low-quality referral output

## How this service works

Job listings and hiring data for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.

## Output

Returns a JSON object with a success boolean and a data object containing the generated referral content for the specified target role and company, personalized based on provided relationship context and achievements.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "target_role",
  "target_company"
 ],
 "properties": {
  "target_role": {
   "type": "string"
  },
  "achievements": {
   "type": "string"
  },
  "relationship": {
   "type": "string"
  },
  "target_company": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/roster-referral-generator-e8953740/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from raoster.orbonomy.xyz](https://www.zero.xyz/host/raoster.orbonomy.xyz/llms.txt)