> **For AI agents:** this page is a focused, LLM-optimized view of a
> single Fiber AI operation. Before calling it, fetch the routing
> instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation
> index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md).

# syncBudgetedContactReveal

`POST /v1/contact-details/reveal`

**Tags:** `Contact details`

Reveal contact details (time-budgeted)

**Endpoint:** `https://api.fiber.ai/v1/contact-details/reveal`

## Description

Return a person's work email, personal email, and/or phone number, guaranteed to finish within your specified time window. You can pick how deep in our 'waterfall' we go; higher depths increase yield but will cost more. This is a beta endpoint, but we recommend trying it over the other contact reveal endpoints.

⚡ Rate limit: 120 requests per 1 minute

💰 Cost: Only delivered items are billed — nothing delivered means nothing charged. Prices by depth:• instant — 1 credit(s) per email type, 1 if phone numbers are delivered.• quick — 1 credit(s) per email type, 2 if phone numbers are delivered.• medium — flat bundle: 5 credit(s) for emails + phone, 3 all emails, 2 work email only, 2 personal email only, 3 phone only, 5 work email + phone, 5 personal email + phone. ⓘ

⏱ Recommended timeout: 90 seconds ⓘ

## Request body (JSON Schema)

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "apiKey": {
          "type": "string",
          "description": "Your Fiber API key"
        },
        "linkedinUrl": {
          "type": "string",
          "minLength": 1,
          "description": "The person's LinkedIn identifier. Accepts a full LinkedIn profile URL (e.g. 'https://www.linkedin.com/in/williamhgates/'), a bare slug (e.g. 'williamhgates'), a Sales Navigator URN (e.g. 'ACwAAA-001MBbIvJon'), or a numeric LinkedIn user ID (e.g. '443105112')."
        },
        "enrichmentType": {
          "type": "object",
          "properties": {
            "getWorkEmails": {
              "type": "boolean",
              "default": true
            },
            "getPersonalEmails": {
              "type": "boolean",
              "default": true
            },
            "getPhoneNumbers": {
              "type": "boolean",
              "default": true
            }
          },
          "description": "Which email and phone types to look for.",
          "default": {
            "getWorkEmails": true,
            "getPersonalEmails": true,
            "getPhoneNumbers": true
          }
        },
        "timeBudgetMs": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 3000,
          "maximum": 600000,
          "description": "How long this call may run, in milliseconds. Omit to use the default for the chosen depth."
        },
        "company": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "linkedinUrl"
                  ]
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "LinkedIn company URL (e.g. 'https://www.linkedin.com/company/openai')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "linkedinSlug"
                  ]
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "LinkedIn company slug (e.g. 'openai')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "linkedinOrgId"
                  ]
                },
                "value": {
                  "type": "string",
                  "pattern": "^\\d+$",
                  "minLength": 1,
                  "description": "LinkedIn numeric organization ID (e.g. '11130470')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "domain"
                  ]
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Company website domain (e.g. 'openai.com')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional current company of the person. When provided, work emails whose domain does not match this company are returned in unmatchedWorkEmails instead of emails. Set identifier to 'linkedinUrl', 'linkedinSlug', 'linkedinOrgId', or 'domain' and provide the corresponding value."
        },
        "depth": {
          "type": "string",
          "description": "Stored contact details only — no deliverability check. Waits 10 seconds when timeBudgetMs is omitted. Priced by this choice and what is delivered, not by how long the lookup takes.",
          "enum": [
            "instant"
          ]
        }
      },
      "required": [
        "apiKey",
        "linkedinUrl",
        "depth"
      ]
    },
    {
      "type": "object",
      "properties": {
        "apiKey": {
          "type": "string",
          "description": "Your Fiber API key"
        },
        "linkedinUrl": {
          "type": "string",
          "minLength": 1,
          "description": "The person's LinkedIn identifier. Accepts a full LinkedIn profile URL (e.g. 'https://www.linkedin.com/in/williamhgates/'), a bare slug (e.g. 'williamhgates'), a Sales Navigator URN (e.g. 'ACwAAA-001MBbIvJon'), or a numeric LinkedIn user ID (e.g. '443105112')."
        },
        "enrichmentType": {
          "type": "object",
          "properties": {
            "getWorkEmails": {
              "type": "boolean",
              "default": true
            },
            "getPersonalEmails": {
              "type": "boolean",
              "default": true
            },
            "getPhoneNumbers": {
              "type": "boolean",
              "default": true
            }
          },
          "description": "Which email and phone types to look for.",
          "default": {
            "getWorkEmails": true,
            "getPersonalEmails": true,
            "getPhoneNumbers": true
          }
        },
        "timeBudgetMs": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 3000,
          "maximum": 600000,
          "description": "How long this call may run, in milliseconds. Omit to use the default for the chosen depth."
        },
        "company": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "linkedinUrl"
                  ]
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "LinkedIn company URL (e.g. 'https://www.linkedin.com/company/openai')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "linkedinSlug"
                  ]
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "LinkedIn company slug (e.g. 'openai')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "linkedinOrgId"
                  ]
                },
                "value": {
                  "type": "string",
                  "pattern": "^\\d+$",
                  "minLength": 1,
                  "description": "LinkedIn numeric organization ID (e.g. '11130470')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "domain"
                  ]
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Company website domain (e.g. 'openai.com')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional current company of the person. When provided, work emails whose domain does not match this company are returned in unmatchedWorkEmails instead of emails. Set identifier to 'linkedinUrl', 'linkedinSlug', 'linkedinOrgId', or 'domain' and provide the corresponding value."
        },
        "depth": {
          "type": "string",
          "description": "Stored contact details plus a live search. Waits 30 seconds when timeBudgetMs is omitted. Priced by this choice and what is delivered, not by how long the lookup takes.",
          "enum": [
            "quick"
          ]
        },
        "validateEmails": {
          "type": "boolean",
          "default": true,
          "description": "Whether to check email addresses for deliverability before returning them."
        }
      },
      "required": [
        "apiKey",
        "linkedinUrl",
        "depth"
      ]
    },
    {
      "type": "object",
      "properties": {
        "apiKey": {
          "type": "string",
          "description": "Your Fiber API key"
        },
        "linkedinUrl": {
          "type": "string",
          "minLength": 1,
          "description": "The person's LinkedIn identifier. Accepts a full LinkedIn profile URL (e.g. 'https://www.linkedin.com/in/williamhgates/'), a bare slug (e.g. 'williamhgates'), a Sales Navigator URN (e.g. 'ACwAAA-001MBbIvJon'), or a numeric LinkedIn user ID (e.g. '443105112')."
        },
        "enrichmentType": {
          "type": "object",
          "properties": {
            "getWorkEmails": {
              "type": "boolean",
              "default": true
            },
            "getPersonalEmails": {
              "type": "boolean",
              "default": true
            },
            "getPhoneNumbers": {
              "type": "boolean",
              "default": true
            }
          },
          "description": "Which email and phone types to look for.",
          "default": {
            "getWorkEmails": true,
            "getPersonalEmails": true,
            "getPhoneNumbers": true
          }
        },
        "timeBudgetMs": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 3000,
          "maximum": 600000,
          "description": "How long this call may run, in milliseconds. Omit to use the default for the chosen depth."
        },
        "company": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "linkedinUrl"
                  ]
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "LinkedIn company URL (e.g. 'https://www.linkedin.com/company/openai')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "linkedinSlug"
                  ]
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "LinkedIn company slug (e.g. 'openai')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "linkedinOrgId"
                  ]
                },
                "value": {
                  "type": "string",
                  "pattern": "^\\d+$",
                  "minLength": 1,
                  "description": "LinkedIn numeric organization ID (e.g. '11130470')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "enum": [
                    "domain"
                  ]
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Company website domain (e.g. 'openai.com')."
                }
              },
              "required": [
                "identifier",
                "value"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional current company of the person. When provided, work emails whose domain does not match this company are returned in unmatchedWorkEmails instead of emails. Set identifier to 'linkedinUrl', 'linkedinSlug', 'linkedinOrgId', or 'domain' and provide the corresponding value."
        },
        "depth": {
          "type": "string",
          "description": "Stored contact details plus the broadest live search. Waits 90 seconds when timeBudgetMs is omitted. Priced by this choice and what is delivered, not by how long the lookup takes.",
          "enum": [
            "medium"
          ]
        },
        "validateEmails": {
          "type": "boolean",
          "default": true,
          "description": "Whether to check email addresses for deliverability before returning them."
        }
      },
      "required": [
        "apiKey",
        "linkedinUrl",
        "depth"
      ]
    }
  ]
}
```

## Response — success (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "output": {
      "type": "object",
      "properties": {
        "profile": {
          "type": "object",
          "properties": {
            "name": {
              "type": [
                "string",
                "null"
              ],
              "description": "The person's full name. Null when unavailable."
            },
            "emails": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "work",
                      "personal"
                    ],
                    "description": "Whether this address is a work email or a personal email."
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "valid",
                      "risky",
                      "unknown",
                      "invalid"
                    ],
                    "description": "Deliverability of this address. Only `valid` has passed a deliverability check."
                  }
                },
                "required": [
                  "email",
                  "type",
                  "status"
                ]
              }
            },
            "unmatchedWorkEmails": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "work",
                      "personal"
                    ],
                    "description": "Whether this address is a work email or a personal email."
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "valid",
                      "risky",
                      "unknown",
                      "invalid"
                    ],
                    "description": "Deliverability of this address. Only `valid` has passed a deliverability check."
                  }
                },
                "required": [
                  "email",
                  "type",
                  "status"
                ]
              },
              "description": "Work emails whose domain does not match the person's current company (or the company you specified). Not included in emails; present only when at least one was found."
            },
            "phoneNumbers": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "number": {
                    "type": "string",
                    "description": "The phone number."
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "mobile",
                      "other"
                    ],
                    "description": "Whether this number is a mobile number."
                  }
                },
                "required": [
                  "number",
                  "type"
                ]
              }
            },
            "linkedinUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "Public LinkedIn profile URL. Null when none is available."
            }
          },
          "required": [
            "emails",
            "phoneNumbers"
          ]
        }
      },
      "required": [
        "profile"
      ]
    },
    "chargeInfo": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-now"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged"
          ],
          "description": "Credits were charged immediately for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charging-later"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "Credits will be charged after the operation completes"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-for-async-process"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged",
            "message"
          ],
          "description": "Credits that were charged for an asynchronous operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "free"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "No credits were charged for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "credits-refunded"
              ]
            },
            "creditsRefunded": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsRefunded",
            "message"
          ],
          "description": "Credits were refunded for this operation"
        }
      ]
    },
    "warnings": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "Full path to extraneous field (e.g., 'searchParams.ExtraField')"
          },
          "message": {
            "type": "string",
            "description": "Warning message"
          }
        },
        "required": [
          "field",
          "message"
        ]
      },
      "description": "Warnings about extraneous fields in request"
    },
    "advice": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "Tips, recommendations, and suggestions for using this API effectively."
    }
  },
  "required": [
    "output",
    "chargeInfo"
  ],
  "additionalProperties": false
}
```

---

Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json)
Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)