# Open Source Filings — Sample Single Record by ID

> Open Source Filings — Sample Single Record by ID is a paid API for AI agents from api.osf-master-server.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Fetches a single verifiable public-data record from the OSF catalog by record_id for $0.001, returning the full JSON payload plus a provenance URL to the authoritative primary source.

## Facts

- Endpoint: GET https://api.osf-master-server.com/x402/sample/:record_id
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/open-source-filings-sample-single-record-by-id-65ef88a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aWA5d2OD7oJLMHVt4tOO4

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 open-source-filings-sample-single-record-by-id-65ef88a7
```

Example prompt: Pull the OSF catalog sample record with ID 48291 in JSON format so I can see the full data payload and its provenance URL before I decide whether to run a full search.

## When to prefer this

Use this endpoint when you want to inspect or verify a specific known record from the OSF catalog before committing to a full search or bulk purchase. It is ideal for due diligence on data quality, checking provenance, or previewing a single record type cheaply. Prefer this over the search endpoints when you already have a record_id from the free catalog and just need the full payload.

## Known failure modes

- Record ID not found in catalog — returns 404 or error status
- Daily fair-use cap per wallet exceeded — request blocked until reset
- Insufficient USDC balance for $0.001 payment — payment fails
- Invalid or missing format query parameter — returns 400 validation error
- Record ID is not a valid integer — schema validation failure

## How this service works

Sample any single record in the OSF catalog for $0.001: the full JSON payload plus a provenance URL to the authoritative primary source. A low cost way for an autonomous agent to try the data before buying at the standard per record or search price. One verified record per call keyed by record_id from the free catalog, across 80 sources of US government and scientific data. Fair use daily cap per wallet.

## Output

A JSON object containing the full record data payload, the record_id, a provenance_url pointing to the authoritative primary source, the data source name, data_type, and a status field. This lets you verify the content and quality of a specific OSF catalog record before committing to larger queries.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "format"
     ],
     "properties": {
      "format": {
       "type": "string",
       "description": "Response format (json)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "status",
      "record_id",
      "data",
      "provenance_url"
     ],
     "properties": {
      "data": {
       "type": "object"
      },
      "source": {
       "type": "string"
      },
      "status": {
       "type": "string"
      },
      "data_type": {
       "type": "string"
      },
      "record_id": {
       "type": "integer"
      },
      "provenance_url": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/open-source-filings-sample-single-record-by-id-65ef88a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.osf-master-server.com](https://www.zero.xyz/host/api.osf-master-server.com/llms.txt)
