{"openapi":"3.1.0","info":{"title":"ProfileProof API","summary":"LinkedIn profile acquisition and structured normalization","description":"Acquires authenticated LinkedIn profile data and normalizes it into a typed professional schema with explicit provenance and limitations.","version":"1.1.0"},"paths":{"/health":{"get":{"tags":["operations"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/readyz":{"get":{"tags":["operations"],"summary":"Readiness","operationId":"readiness_readyz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/metrics":{"get":{"tags":["operations"],"summary":"Metrics","operationId":"metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/capabilities":{"get":{"tags":["operations"],"summary":"Capabilities","operationId":"capabilities_v1_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesResponse"}}}}}}},"/v1/profiles/resolve":{"post":{"tags":["profiles"],"summary":"Resolve Profile","operationId":"resolve_profile_v1_profiles_resolve_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Unauthorized"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Unprocessable Entity"},"424":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Failed Dependency"}}}}},"components":{"schemas":{"CapabilitiesResponse":{"properties":{"providers":{"items":{"$ref":"#/components/schemas/ProviderCapability"},"type":"array","title":"Providers"}},"type":"object","required":["providers"],"title":"CapabilitiesResponse"},"Certification":{"properties":{"name":{"type":"string","maxLength":300,"minLength":1,"title":"Name"},"issuer":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Issuer"},"issued":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Issued"},"expires":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Expires"},"credential_id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Credential Id"},"credential_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Credential Url"}},"additionalProperties":false,"type":"object","required":["name"],"title":"Certification"},"DateRange":{"properties":{"start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start"},"end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End"},"is_current":{"type":"boolean","title":"Is Current","default":false}},"additionalProperties":false,"type":"object","title":"DateRange"},"Education":{"properties":{"school":{"type":"string","maxLength":300,"minLength":1,"title":"School"},"degree":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Degree"},"field_of_study":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Field Of Study"},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Description"},"dates":{"$ref":"#/components/schemas/DateRange"}},"additionalProperties":false,"type":"object","required":["school"],"title":"Education"},"Experience":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"company":{"type":"string","maxLength":200,"minLength":1,"title":"Company"},"location":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Location"},"description":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Description"},"employment_type":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Employment Type"},"dates":{"$ref":"#/components/schemas/DateRange"}},"additionalProperties":false,"type":"object","required":["company"],"title":"Experience"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"version":{"type":"string","title":"Version"},"environment":{"type":"string","title":"Environment"}},"type":"object","required":["status","version","environment"],"title":"HealthResponse"},"Language":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"proficiency":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Proficiency"}},"additionalProperties":false,"type":"object","required":["name"],"title":"Language"},"Problem":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"status":{"type":"integer","title":"Status"},"detail":{"type":"string","title":"Detail"},"instance":{"type":"string","title":"Instance"},"request_id":{"type":"string","title":"Request Id"}},"type":"object","required":["type","title","status","detail","instance","request_id"],"title":"Problem"},"ProfileData":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Name"},"headline":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Headline"},"location":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Location"},"about":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}],"title":"About"},"experience":{"items":{"$ref":"#/components/schemas/Experience"},"type":"array","maxItems":100,"title":"Experience"},"education":{"items":{"$ref":"#/components/schemas/Education"},"type":"array","maxItems":100,"title":"Education"},"skills":{"items":{"type":"string"},"type":"array","maxItems":500,"title":"Skills"},"certifications":{"items":{"$ref":"#/components/schemas/Certification"},"type":"array","maxItems":100,"title":"Certifications"},"languages":{"items":{"$ref":"#/components/schemas/Language"},"type":"array","maxItems":100,"title":"Languages"},"images":{"$ref":"#/components/schemas/ProfileImages"}},"additionalProperties":false,"type":"object","title":"ProfileData"},"ProfileImages":{"properties":{"profile":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Profile"},"background":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Background"}},"additionalProperties":false,"type":"object","title":"ProfileImages"},"ProfileResponse":{"properties":{"schema_version":{"type":"string","title":"Schema Version","default":"1.1"},"canonical_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Canonical Url"},"public_identifier":{"type":"string","title":"Public Identifier"},"profile":{"$ref":"#/components/schemas/ProfileData"},"source":{"$ref":"#/components/schemas/SourceInfo"},"meta":{"$ref":"#/components/schemas/ResolveMeta"}},"type":"object","required":["canonical_url","public_identifier","profile","source","meta"],"title":"ProfileResponse"},"ProviderCapability":{"properties":{"name":{"$ref":"#/components/schemas/ProviderName"},"configured":{"type":"boolean","title":"Configured"},"real_data":{"type":"boolean","title":"Real Data"},"description":{"type":"string","title":"Description"}},"type":"object","required":["name","configured","real_data","description"],"title":"ProviderCapability"},"ProviderName":{"type":"string","enum":["demo","linkedin_direct"],"title":"ProviderName"},"ResolveMeta":{"properties":{"request_id":{"type":"string","title":"Request Id"},"fetched_at":{"type":"string","format":"date-time","title":"Fetched At"},"cached":{"type":"boolean","title":"Cached"},"completeness":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Completeness"},"fields_present":{"items":{"type":"string"},"type":"array","title":"Fields Present"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["request_id","fetched_at","cached","completeness","fields_present"],"title":"ResolveMeta"},"ResolveRequest":{"properties":{"profile_url":{"type":"string","maxLength":500,"minLength":1,"title":"Profile Url"},"provider":{"$ref":"#/components/schemas/ProviderName","default":"linkedin_direct"}},"additionalProperties":false,"type":"object","required":["profile_url"],"title":"ResolveRequest"},"SourceInfo":{"properties":{"provider":{"$ref":"#/components/schemas/ProviderName"},"mode":{"type":"string","title":"Mode"},"consented":{"type":"boolean","title":"Consented"},"licensed":{"type":"boolean","title":"Licensed","default":false},"match_confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Match Confidence"},"dataset_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Version"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"type":"object","required":["provider","mode","consented"],"title":"SourceInfo"}}}}