Discovery API
Get Details
Get full parameter information for an endpoint
POST
https://www.orthogonal.com/v1/details
Get complete details about a specific API endpoint, including all parameters, types, and descriptions.
Request
apistringrequired
API slug from search results (e.g., “apollo”, “linkup”, “olostep”)
pathstringrequired
Endpoint path (e.g., “/v1/people/match”, “/v1/search”)
Response
{
"success": true,
"api": {
"name": "Apollo.io",
"slug": "apollo",
"description": "B2B lead enrichment and contact database",
"baseUrl": "https://api.apollo.io",
"verified": true
},
"endpoint": {
"path": "/v1/people/match",
"method": "POST",
"description": "Enrich a person by email, name, or LinkedIn URL",
"price": "$0.03",
"isPayable": true,
"docsUrl": "https://apolloio.github.io/apollo-api-docs",
"bodyType": "object",
"pathParams": [],
"queryParams": [],
"bodyParams": [
{
"name": "email",
"type": "string",
"required": false,
"description": "Email address to enrich"
},
{
"name": "first_name",
"type": "string",
"required": false,
"description": "First name of the person"
},
{
"name": "last_name",
"type": "string",
"required": false,
"description": "Last name of the person"
},
{
"name": "organization_name",
"type": "string",
"required": false,
"description": "Company name"
},
{
"name": "linkedin_url",
"type": "string",
"required": false,
"description": "LinkedIn profile URL"
}
]
},
"usage": {
"runApi": "POST /v1/run with {\"api\": \"apollo\", \"path\": \"/v1/people/match\", ...}",
"x402": "https://www.orthogonal.com/pay/apollo/v1/people/match"
}
}
Response Fields
| Field | Description |
|---|---|
api | API metadata (name, slug, description, verification status) |
endpoint.pathParams | URL path parameters like {id} |
endpoint.queryParams | Query string parameters |
endpoint.bodyParams | Request body parameters |
endpoint.price | Cost per call (or “dynamic” for variable pricing) |
usage | Example URLs for calling this endpoint |
Example
curl -X POST 'https://api.orthogonal.com/v1/details' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"api": "apollo",
"path": "/v1/people/match"
}'
Use Case: Building Dynamic Requests
Use details to construct valid API calls programmatically:
// 1. Get endpoint details
const details = await getDetails('apollo', '/v1/people/match');
// 2. Build request body from available params
const body = {};
for (const param of details.endpoint.bodyParams) {
if (userInput[param.name]) {
body[param.name] = userInput[param.name];
}
}
// 3. Make the API call
const result = await run('apollo', '/v1/people/match', { body });