phone_number — Orange Slice capability

Outcome-priced capability. One price for the answer, whichever providers it took. Everything we expose, with prices: https://orangeslice.ai/llms.txt

Finds a phone number for a person. Costs ten times a work email, so reach for it on high-value prospects rather than a whole list. Billed only when a number is found.

Price

$0.50, charged per hit

Billed only when the answer is found. A miss costs nothing.

The price is a property of the outcome, not of the work behind it. Whichever vendor serves this call, and whatever it costs us, the number above is the number quoted before the run and charged after it.

Call it

CLI

orangeslice enrich phone_number --linkedin-url https://linkedin.com/in/jane-doe # or piped, one JSON object per line: cat people.ndjson | orangeslice enrich phone_number

HTTP

curl -X POST 'https://orangeslice.ai/api/v1/run' \ -H 'Authorization: Bearer $ORANGESLICE_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"capability":"phone_number","input":{"company":"<string>","domain":"<string>","firstName":"<string>"}}'

SDK

await services.person.contact.phoneNumber({ company: "…", domain: "…", firstName: "…" });

Inputs

FieldTypeRequiredDescription
companystringNoCompany name the person works at
domainstringNoCompany domain, used to disambiguate the person
firstNamestringNoPerson's first name
lastNamestringNoPerson's last name
linkedinUrlstringNoLinkedIn profile URL — the most reliable input when available

Inputs may also be piped as NDJSON, one JSON object per line.

Output

{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "phone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "phone_type": { "anyOf": [ { "type": "string", "enum": [ "work", "personal", "unknown" ] }, { "type": "null" } ] }, "personal_phones": { "default": [], "type": "array", "items": { "type": "string" } }, "work_phones": { "default": [], "type": "array", "items": { "type": "string" } }, "unknown_phones": { "default": [], "type": "array", "items": { "type": "string" } } }, "required": [ "phone", "phone_type", "personal_phones", "work_phones", "unknown_phones" ], "additionalProperties": false }

The field that carries the answer is phone. It is null — or empty — when nothing was found, which is how a miss is told from a hit without knowing anything else about this entry.

Before you run

  • Price it first. orangeslice enrich phone_number --dry-run returns the exact dollar cost and spends nothing.
  • Large runs need approval. Above the spend-gate threshold a run exits 7 until it carries a plan token, and only a dry run mints one.
  • Scopes: enrich
  • Permitted uses: research, outreach, export

Exit codes

0 ok · 2 bad input · 3 auth · 4 not found · 5 provider · 6 rate limited · 7 spend gate, nothing billed · 8 timeout · 9 a third-party account needs connecting