{"openapi":"3.1.0","info":{"title":"Newer Law Agent API","version":"1.0.0","description":"Machine interface to Newer Law — David Mitchell, Esq.. Lets AI agents screen matter fit, ask general legal-information questions, and submit inquiries on behalf of a principal seeking U.S. counsel. Viewing this website, contacting the firm, or using any automated interface does not create an attorney-client relationship. No attorney-client relationship exists unless and until a written engagement agreement is signed.","contact":{"name":"David Mitchell, Esq.","email":"david@newerlaw.com","url":"https://www.newerlaw.com"},"x-agent-guide":"https://www.newerlaw.com/agents.md"},"servers":[{"url":"https://www.newerlaw.com"}],"paths":{"/api/firm":{"get":{"operationId":"getFirmProfile","summary":"Complete structured profile of the firm","responses":{"200":{"description":"Profile","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/practice-areas":{"get":{"operationId":"listPracticeAreas","summary":"Practice areas with matter types and visa categories","responses":{"200":{"description":"List","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/practice-areas/{id}":{"get":{"operationId":"getPracticeArea","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["business-contracts","venture-capital-startups","cross-border-transactions","foreign-companies-us-entry","business-immigration","ai-and-agents","outside-general-counsel"]}}],"responses":{"200":{"description":"Practice area"},"404":{"description":"Unknown id"}}}},"/api/packages":{"get":{"operationId":"listServicePackages","summary":"Agent-ready, fixed-scope service packages with deliverables and key dates","responses":{"200":{"description":"List","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/packages/{id}":{"get":{"operationId":"getServicePackage","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["uspto-trademark-foreign-applicant","ny-llc-transparency-act","federal-cta-foreign-entities","firpta-withholding-certificate","foreign-founder-delaware-c-corp"]}}],"responses":{"200":{"description":"Package"},"404":{"description":"Unknown id"}}}},"/api/insights":{"get":{"operationId":"listInsights","summary":"Articles written by the attorney","responses":{"200":{"description":"List"}}}},"/api/insights/{slug}":{"get":{"operationId":"readInsight","summary":"Full article as markdown (JSON-wrapped)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","enum":["cta-foreign-entities-after-fincen-final-rule","new-york-llc-transparency-act-filing-guide","loper-bright-eb1-final-merits","new-york-qsbs-decoupling","ai-agents-crypto-wallets-legal-frontier","structuring-us-entity","foreign-companies-entity-selection","safe-not-simple","eb5-after-reform-act"]}}],"responses":{"200":{"description":"Article"},"404":{"description":"Unknown slug"}}}},"/api/fit":{"post":{"operationId":"assessMatterFit","summary":"Deterministic screen: is this matter within the firm's practice?","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["description"],"properties":{"description":{"type":"string","maxLength":6000},"matterType":{"type":"string","enum":["business-contracts","venture-capital-startups","cross-border-transactions","foreign-companies-us-entry","business-immigration","ai-and-agents","outside-general-counsel"]},"servicePackage":{"type":"string","enum":["uspto-trademark-foreign-applicant","ny-llc-transparency-act","federal-cta-foreign-entities","firpta-withholding-certificate","foreign-founder-delaware-c-corp"]},"jurisdiction":{"type":"string"},"urgency":{"type":"string"},"principalType":{"type":"string"}}}}}},"responses":{"200":{"description":"Assessment","content":{"application/json":{"schema":{"type":"object","properties":{"fit":{"type":"string","enum":["likely","possible","partial","unlikely","undetermined"]},"confidence":{"type":"number"},"reason":{"type":"string"},"practiceAreas":{"type":"array"},"servicePackages":{"type":"array"},"adjacentAreas":{"type":"array"},"outOfScope":{"type":"array"},"notes":{"type":"array"},"recommendedNextStep":{"type":"object"}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"errors":{"type":"array","items":{"type":"string"}},"retryAfterSec":{"type":"integer"}}}}}}}}},"/api/inquiry":{"post":{"operationId":"submitInquiry","summary":"Submit an inquiry on behalf of a principal","description":"Sends an acknowledgment to the principal and a notification to the attorney, who follows up personally. Both consent flags are required. Do not include confidential information.","parameters":[{"name":"X-Agent-Name","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent","principal","matter","consent"],"properties":{"agent":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Name of the agent or system submitting the inquiry."},"operator":{"type":"string"},"version":{"type":"string"},"contact":{"type":"string"}}},"principal":{"type":"object","required":["name","email"],"properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string"},"company":{"type":"string"},"type":{"type":"string","enum":["individual","company","investor","fund","other"]},"country":{"type":"string"},"timezone":{"type":"string"},"preferredContact":{"type":"string","enum":["email","phone"]}}},"matter":{"type":"object","required":["summary"],"properties":{"practiceArea":{"type":"string","enum":["business-contracts","venture-capital-startups","cross-border-transactions","foreign-companies-us-entry","business-immigration","ai-and-agents","outside-general-counsel"]},"servicePackage":{"type":"string","enum":["uspto-trademark-foreign-applicant","ny-llc-transparency-act","federal-cta-foreign-entities","firpta-withholding-certificate","foreign-founder-delaware-c-corp"],"description":"Optional. A defined agent-ready service package."},"summary":{"type":"string","minLength":20,"maxLength":4000,"description":"Non-confidential description of the need."},"jurisdiction":{"type":"string"},"urgency":{"type":"string","enum":["routine","time-sensitive","urgent"]},"deadline":{"type":"string","format":"date"},"counterparties":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Names of other parties, for the conflict check."}}},"consent":{"type":"object","required":["acknowledgesNoAttorneyClientRelationship","principalAuthorizedAgent"],"properties":{"acknowledgesNoAttorneyClientRelationship":{"type":"boolean","const":true},"principalAuthorizedAgent":{"type":"boolean","const":true}}}}}}}},"responses":{"200":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"inquiryId":{"type":"string"},"received":{"type":"string","format":"date-time"},"acknowledgment":{"type":"string"},"fitScreen":{"type":"object"},"nextSteps":{"type":"array","items":{"type":"string"}},"disclaimers":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"errors":{"type":"array","items":{"type":"string"}},"retryAfterSec":{"type":"integer"}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"errors":{"type":"array","items":{"type":"string"}},"retryAfterSec":{"type":"integer"}}}}}},"502":{"description":"Delivery failed","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"errors":{"type":"array","items":{"type":"string"}},"retryAfterSec":{"type":"integer"}}}}}},"503":{"description":"Email not configured","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"errors":{"type":"array","items":{"type":"string"}},"retryAfterSec":{"type":"integer"}}}}}}}}},"/api/ask":{"post":{"operationId":"askLegalInformationQuestion","summary":"General legal information (not advice) within the firm's practice areas","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"type":"string","maxLength":2000},"context":{"type":"string","maxLength":1500}}}}}},"responses":{"200":{"description":"Answer","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"answer":{"type":"string"},"remaining":{"type":"integer"},"disclaimer":{"type":"string"},"nextStep":{"type":"object"}}}}}},"429":{"description":"Daily limit reached","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"errors":{"type":"array","items":{"type":"string"}},"retryAfterSec":{"type":"integer"}}}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"errors":{"type":"array","items":{"type":"string"}},"retryAfterSec":{"type":"integer"}}}}}}}}}},"components":{"schemas":{"Inquiry":{"type":"object","required":["agent","principal","matter","consent"],"properties":{"agent":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Name of the agent or system submitting the inquiry."},"operator":{"type":"string"},"version":{"type":"string"},"contact":{"type":"string"}}},"principal":{"type":"object","required":["name","email"],"properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string"},"company":{"type":"string"},"type":{"type":"string","enum":["individual","company","investor","fund","other"]},"country":{"type":"string"},"timezone":{"type":"string"},"preferredContact":{"type":"string","enum":["email","phone"]}}},"matter":{"type":"object","required":["summary"],"properties":{"practiceArea":{"type":"string","enum":["business-contracts","venture-capital-startups","cross-border-transactions","foreign-companies-us-entry","business-immigration","ai-and-agents","outside-general-counsel"]},"servicePackage":{"type":"string","enum":["uspto-trademark-foreign-applicant","ny-llc-transparency-act","federal-cta-foreign-entities","firpta-withholding-certificate","foreign-founder-delaware-c-corp"],"description":"Optional. A defined agent-ready service package."},"summary":{"type":"string","minLength":20,"maxLength":4000,"description":"Non-confidential description of the need."},"jurisdiction":{"type":"string"},"urgency":{"type":"string","enum":["routine","time-sensitive","urgent"]},"deadline":{"type":"string","format":"date"},"counterparties":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Names of other parties, for the conflict check."}}},"consent":{"type":"object","required":["acknowledgesNoAttorneyClientRelationship","principalAuthorizedAgent"],"properties":{"acknowledgesNoAttorneyClientRelationship":{"type":"boolean","const":true},"principalAuthorizedAgent":{"type":"boolean","const":true}}}}},"Error":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"errors":{"type":"array","items":{"type":"string"}},"retryAfterSec":{"type":"integer"}}}}}}