{"components":{"schemas":{"CompanyProfile":{"description":"Company profile for matching against obligations","properties":{"business_states":{"description":"US states where company operates","items":{"type":"string"},"type":"array"},"country":{"default":"USA","type":"string"},"employee_count":{"type":"integer"},"entity_type":{"description":"LLC, C-Corporation, S-Corporation, etc.","type":"string"},"industry":{"type":"string"},"is_government_contractor":{"type":"boolean"},"naics_code":{"type":"string"},"pe_countries":{"description":"Countries with permanent establishment","items":{"type":"string"},"type":"array"},"state":{"description":"State of incorporation","type":"string"}},"type":"object"},"Obligation":{"properties":{"applicability_rules":{"description":"Machine-readable rules for determining if this obligation applies to a company","properties":{"country":{"type":"string"},"entity_types":{"items":{"type":"string"},"type":"array"},"industries":{"items":{"type":"string"},"type":"array"},"jurisdictions":{"items":{"type":"string"},"type":"array"},"max_employees":{"nullable":true,"type":"integer"},"min_employees":{"nullable":true,"type":"integer"}},"type":"object"},"category":{"description":"Domain: Tax, Legal, HR, Benefits, Security","type":"string"},"confidence_level":{"enum":["high","medium","low"],"type":"string"},"department":{"description":"Responsible department","type":"string"},"description":{"description":"Detailed description of what is required","type":"string"},"effective_from":{"format":"date","nullable":true,"type":"string"},"jurisdiction":{"description":"Geographic jurisdiction (e.g. California, Federal, United Kingdom)","type":"string"},"legal_citation":{"description":"Specific statute or regulation reference","type":"string"},"penalty_description":{"description":"Consequences of non-compliance","type":"string"},"penalty_severity":{"enum":["critical","high","medium","low"],"type":"string"},"priority":{"enum":["critical","high","medium","low"],"type":"string"},"recurring":{"description":"Filing frequency: annual, quarterly, monthly, one-time","type":"string"},"slug":{"description":"Unique identifier for the obligation","type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"description":"Name of the compliance obligation","type":"string"},"verified":{"type":"boolean"}},"type":"object"}},"securitySchemes":{"ApiKeyAuth":{"description":"API key passed as Bearer token. Listings are free (no key needed). Match endpoint and applicability rules require a key.","scheme":"bearer","type":"http"}}},"info":{"contact":{"name":"Compliance Singularity","url":"https://compliancesingularity.com"},"description":"Read-only API for querying the Compliance Singularity catalog of regulatory obligations. Returns structured compliance obligations with legal citations, penalties, deadlines, and machine-readable applicability rules. Use this to determine what regulatory obligations apply to a company based on jurisdiction, entity type, industry, and size.","title":"Compliance Singularity API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/coverage":{"get":{"operationId":"getCoverage","responses":{"200":{"description":"Coverage score with jurisdiction, domain, freshness, and international dimensions"}},"summary":"Get catalog coverage score and dimensional breakdown"}},"/api/v1/deadlines":{"get":{"operationId":"listDeadlines","parameters":[{"in":"query","name":"jurisdiction","schema":{"type":"string"}},{"in":"query","name":"category","schema":{"type":"string"}}],"responses":{"200":{"description":"List of obligations with recurring deadlines"}},"summary":"List recurring compliance deadlines, optionally filtered by jurisdiction"}},"/api/v1/jurisdictions":{"get":{"operationId":"listJurisdictions","responses":{"200":{"description":"Jurisdiction list with counts"}},"summary":"List all jurisdictions with obligation counts"}},"/api/v1/match":{"post":{"description":"Send a company profile and receive back all compliance obligations that apply with full applicability rules. Requires API key. This is the primary endpoint for AI agents determining what a company needs to comply with.","operationId":"matchProfile","requestBody":{"content":{"application/json":{"example":{"business_states":["California","New York","Texas"],"country":"USA","employee_count":55,"entity_type":"C-Corporation","industry":"SaaS","state":"Delaware"},"schema":{"$ref":"#/components/schemas/CompanyProfile"}}},"required":true},"responses":{"200":{"description":"List of applicable obligations with applicability rules"}},"summary":"Match a company profile against all obligations (API key required)"}},"/api/v1/obligations":{"get":{"description":"Returns paginated list of active compliance obligations. Filter by jurisdiction, category, entity type, or industry. No API key required.","operationId":"listObligations","parameters":[{"description":"Filter by jurisdiction name (e.g. California, Federal)","in":"query","name":"jurisdiction","schema":{"type":"string"}},{"description":"Filter by category (Tax, Legal, HR, Benefits, Security)","in":"query","name":"category","schema":{"type":"string"}},{"description":"Filter by entity type in applicability rules","in":"query","name":"entity_type","schema":{"type":"string"}},{"description":"Filter by industry in applicability rules","in":"query","name":"industry","schema":{"type":"string"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"per_page","schema":{"default":50,"maximum":100,"type":"integer"}}],"responses":{"200":{"description":"List of obligations with pagination metadata"}},"summary":"List compliance obligations with optional filters (free, no key required)"}},"/api/v1/obligations/search":{"get":{"operationId":"searchObligations","parameters":[{"description":"Search query","in":"query","name":"q","required":true,"schema":{"minLength":2,"type":"string"}},{"in":"query","name":"limit","schema":{"default":20,"maximum":50,"type":"integer"}}],"responses":{"200":{"description":"Matching obligations"}},"summary":"Full-text search across obligation titles, descriptions, and citations"}},"/api/v1/obligations/{slug}":{"get":{"operationId":"getObligation","parameters":[{"description":"Obligation slug identifier","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Full obligation details with applicability rules"},"404":{"description":"Obligation not found"}},"summary":"Get obligation details. Applicability rules require API key."}},"/api/v1/submissions/{id}":{"get":{"operationId":"getSubmissionStatus","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Submission status with optional catalog_item_id"},"404":{"description":"Submission not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Check status of own submission (API key required)"}},"/api/v1/submit":{"post":{"description":"Submit a regulation or compliance obligation to be added to the catalog after review.","operationId":"submitObligation","requestBody":{"content":{"application/json":{"schema":{"properties":{"applicability_notes":{"type":"string"},"category":{"enum":["Tax","Legal","HR","Benefits","Security"],"type":"string"},"description":{"type":"string"},"effective_date":{"format":"date","type":"string"},"jurisdiction":{"type":"string"},"legal_citation":{"type":"string"},"penalty_description":{"type":"string"},"recurring":{"enum":["annual","quarterly","monthly","one-time"],"type":"string"},"source_url":{"format":"uri","type":"string"},"title":{"type":"string"}},"required":["title","jurisdiction","legal_citation"],"type":"object"}}},"required":true},"responses":{"201":{"description":"Submission created with id and status"},"422":{"description":"Missing required fields"}},"security":[{"ApiKeyAuth":[]}],"summary":"Submit a new compliance obligation for review (API key required)"}}},"security":[{"ApiKeyAuth":[]}],"servers":[{"description":"Production","url":"https://compliancesingularity.com"}]}