> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.middesk.com/api-reference/business-verification/businesses/create-business/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server. # Create a business POST https://api.middesk.com/v1/businesses Content-Type: application/json Reference: https://docs.middesk.com/api-reference/business-verification/businesses/create-business ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Body (application/json) This endpoint expects an object. - `name` (string, required) - `addresses` (list of BusinessRequestParamAddressesItem, required) - `tin` (BusinessRequestParamTin, optional) - `website` (BusinessRequestParamWebsite, optional) — Website information for the business. Required when name and addresses are not provided when ordering the web_analysis and/or industry_classification subproducts. - `phone_numbers` (list of BusinessRequestParamPhoneNumbersItem, optional) — Phone numbers for the business. - `people` (list of SubmittedPerson, optional) - `external_id` (string, optional) - `unique_external_id` (string, optional) - `tags` (list of string, optional) - `connection_id` (string, optional) — The ID of a connection to use as the source for this business. Pre-fills the business name and address from the connection. - `orders` (list of BusinessRequestParamOrdersItem, optional) — Orders to place against the business at creation time. Each order specifies a product (and optional subproducts/options) to run. - `registrations` (list of InternationalRegistrationRequestParam, optional) — Known international registrations to look up for the business. Requires the International Business Verification package to be enabled for your account. If omitted, Middesk searches for international registrations based on the submitted addresses. ## Response ### 201 business created - `object` (string, required) - `id` (string, required) - `name` (string, required) - `status` (enum, required) — Current status of the business verification - Allowed values: `open`, `pending`, `in_audit`, `in_review`, `approved`, `rejected` - `created_at` (datetime, required) - `updated_at` (datetime, required) - `external_id` (string, optional, nullable) - `unique_external_id` (string, optional, nullable) - `tags` (list of string, optional) - `requester` (Requester, optional, nullable) - `assignee_id` (string, optional, nullable) - `supported_document_types` (list of enum, optional) - Allowed values: `Articles of Incorporation`, `Certificate of Good Standing` - `review` (Review, optional, nullable) - `tin` (Tin, optional, nullable) - `business_batch_id` (string, optional, nullable) - `formation` (Formation, optional, nullable) - `website` (Website, optional, nullable) - `watchlist` (Watchlist, optional, nullable) - `risk` (BusinessRisk, optional, nullable) — Top-level risk outcome for the business. Populated once a Risk order reaches a terminal state (completed with a verdict, or unavailable). `null` while a Risk order is still in flight. This is the business-level risk outcome; granular per-resource assessments live on the Risk Assessment resource, not here. - `bankruptcies` (list of Bankruptcy, optional) - `certifications` (list of Certification, optional) - `documents` (list of Document, optional) - `liens` (list of Lien, optional) - `names` (list of Name, optional) - `addresses` (list of Address, optional) - `people` (list of Person, optional) - `phone_numbers` (list of PhoneNumber, optional) - `email_addresses` (list of EmailAddress, optional) - `profiles` (list of Profile, optional) - `registrations` (list of Registration, optional) - `orders` (list of Order, optional) - `industry_classification` (IndustryClassification, optional, nullable) - `monitor` (Monitor, optional, nullable) - `tax_exempt_organization` (TaxExemptOrganization, optional, nullable) - `fmcsa_registrations` (list of FmcsaRegistration, optional) - `loans` (list of Loan, optional, nullable) - `litigations` (list of Litigation, optional) - `policy_results` (list of PolicyResult, optional) - `politically_exposed_person_screening` (PoliticallyExposedPersonScreening, optional, nullable) - `adverse_media_screening` (AdverseMediaScreening, optional, nullable) - `signal` (Signal, optional, nullable) - `submitted` (SubmittedAttribute, optional) - `subscription` (Subscription, optional, nullable) - `subscription_availability` (BusinessSubscriptionAvailability, optional, nullable) ## Errors ### 422 Create Business Request Unprocessable Entity Error invalid request - `any` ### 429 Create Business Request Too Many Requests Error Sandbox fixed one-minute account business-creation limit exceeded - `errors` (list of ErrorResponseErrorsItem, required) ### 503 Create Business Request Service Unavailable Error Sandbox business creation rate limit service unavailable - `errors` (list of ErrorResponseErrorsItem, required) ## Types ### BusinessRequestParamAddressesItem ### BusinessRequestParamTin - `tin` (string, optional) ### BusinessRequestParamWebsite Website information for the business. Required when name and addresses are not provided when ordering the web_analysis and/or industry_classification subproducts. - `url` (string, optional) — The website URL for the business ### BusinessRequestParamPhoneNumbersItem - `phone_number` (string, optional) ### SubmittedPerson A person associated with the business. Provide a full `name`, or `first_name` and `last_name`. `people_ucc_liens` and `people_criminal_history` require `first_name` and `last_name`; other person products accept either. - `name` (string, required) — Full name of the person - `first_name` (string, optional) — The person's first (given) name. - `middle_name` (string, optional) — The person's middle name. - `last_name` (string, optional) — The person's last (family) name. - `name_suffix` (string, optional) — Generational suffix for the person (for example `Jr`, `Sr`, or `III`). Used only to narrow `people_ucc_liens` searches by matching debtors whose name includes this suffix. It has no effect on any other order type. - `title` (string, optional) — Job title or role - `email` (string, optional) - `phone` (string, optional) ### BusinessRequestParamOrdersItem - `product` (enum, required) — The product to order. - Allowed values: `identity`, `liens`, `adverse_media`, `bankruptcies`, `business_enrichment`, `documents`, `enhanced_screenings`, `kyc`, `litigations`, `people_litigations`, `people_bankruptcies`, `people_tax_liens`, `people_ucc_liens`, `people_criminal_history`, `tin`, `website`, `business_verification_qualify`, `business_verification_verify`, `tax_liens`, `ucc_liens`, `email_risk` - `subproducts` (list of enum, optional) — Subproducts to include with the order. - Allowed values: `articles_of_incorporation`, `certificate_of_good_standing`, `articles_of_incorporation_with_fallback`, `ucc_documents`, `web_analysis`, `industry_classification` - `options` (BusinessRequestParamOrdersItemOptions, optional) — Per-order configuration flags. ### InternationalRegistrationRequestParam A known international registration to look up for a business. Requires the International Business Verification package to be enabled for your account. - `file_number` (string, required) — The registration or file number issued by the international registry. - `country_code` (string, required) — ISO 3166-1 alpha-2 country code of the registry (e.g., `FR`, `DE`, `GB`). - `jurisdiction_details` (InternationalRegistrationRequestParamJurisdictionDetails, optional) — The sub-national jurisdiction for the registration. ### Requester - `id` (string, required) - `type` (enum, required) - Allowed values: `account`, `user` - `name` (string, required) - `requested_at` (datetime, required) ### Review - `object` (enum, required) - Allowed values: `review` - `id` (string, required) - `created_at` (datetime, required) - `updated_at` (datetime, required) - `tasks` (list of ReviewTask, required) - `completed_at` (datetime, optional, nullable) - `analyst_read_markdown` (string, optional, nullable) — LLM-generated analyst read of the business's verification results, in CommonMark markdown: one lead sentence followed by up to five bullet findings. Inline links, when present, are dashboard-relative paths (for example /businesses/\{id}/registrations) and may be ignored by API consumers. Null until a read has been generated; generated only for businesses without a risk order, whose risk assessment carries its own read. - `analyst_read_generated_at` (datetime, optional, nullable) — When the analyst read was delivered. Null until a read has been generated. - `assignee` (User, optional, nullable) ### Tin - `business_id` (string, required) - `tin` (string, required) - `name` (string, optional, nullable) - `mismatch` (boolean, optional) - `unknown` (boolean, optional) - `verified` (boolean, optional, nullable) - `error` (string, optional, nullable) - `updated_at` (datetime, optional) - `issued` (boolean, optional, nullable) - `verified_by` (string, optional, nullable) ### Formation - `created_at` (datetime, required) - `updated_at` (datetime, required) - `entity_type` (string, optional) - `formation_date` (date, optional) - `formation_state` (string, optional) - `sources` (list of Source, optional) ### Website - `object` (enum, required) - Allowed values: `website` - `id` (string, required) - `url` (string, required, nullable) — The URL that was passed or found for the Business - `created_at` (datetime, required) - `updated_at` (datetime, required) - `status` (enum, required) - Allowed values: `online`, `offline`, `unknown` - `parked` (boolean, required, nullable) — Whether the domain is parked - `submitted` (boolean, required) — Whether the website was submitted by user - `business_id` (string, required) - `business_name_match` (boolean, required) — Whether website content matches business name - `phone_numbers` (list of WebsitePhoneNumber, required) — Phone numbers found on website - `addresses` (list of WebsiteAddressesItem, required) — Addresses found on website - `http_status_code` (integer, optional, nullable) — HTTP response status code - `title` (string, optional, nullable) — Website page title - `description` (string, optional, nullable) — Website meta description - `domain` (WebsiteDomain, optional, nullable) — Domain registration and redirect information - `pages` (list of WebsitePagesItem, optional) — Website pages with screenshots - `error` (string, optional, nullable) — Error message if website analysis failed - `category` (string, optional, nullable) — Website category classification - `platform` (string, optional, nullable) — Website platform (e.g., instagram.com, facebook.com) - `posts_summary` (string, optional, nullable) — Summary of posts found on the website or linked social media profiles - `reviews_summary` (string, optional, nullable) — Summary of reviews found on the website or linked third-party profiles - `names` (list of Name, optional) — Names found on website - `people` (list of map from string to any, optional, nullable) — People found on website - `email_addresses` (list of WebsiteEmailAddressesItem, optional, nullable) — Email addresses found on website - `rating` (WebsiteRating, optional, nullable) ### Watchlist - `object` (string, required) - `id` (string, required) - `hit_count` (integer, required) - `agencies` (list of WatchlistAgency, required) - `lists` (list of WatchlistSource, required) - `people` (list of map from string to any, required) ### BusinessRisk Terminal outcome of a Risk order on the business. `status: completed` carries a verdict (`level`); `status: unavailable` means the run stopped in a failure state and produced no verdict, with a `reason`. Null while a run is in flight. - `object` (enum, required) — The resource type, always `risk`. - Allowed values: `risk` - `status` (enum, required) — Whether the Risk order produced a verdict or stopped unavailable. - Allowed values: `completed`, `unavailable` - `level` (enum, optional) — Categorical risk verdict, present when `status` is `completed`. `not_available` means the run completed but could not produce a conclusive verdict (e.g. an unassessable profile) — distinct from `unavailable`. - Allowed values: `low`, `moderate`, `high`, `not_available` - `score` (integer, optional) — Integer 0-100 risk score, present when `status` is `completed` and the assessment carries a score. `level` is banded from it. - `latest_assessment_id` (string, optional) — Id of the Risk Assessment resource, present when `status` is `completed`. - `reason` (string, optional) — Why no verdict was produced, present when `status` is `unavailable`. ### Bankruptcy - `object` (enum, required) - Allowed values: `bankruptcy` - `id` (string, required) - `business_id` (string, required) - `case_number` (string, required) - `case_updates` (list of BankruptcyCaseUpdatesItem, required) - `chapter` (double, required) - `court` (string, required) - `filing_date` (date, required, nullable) - `debtors` (list of BankruptcyDebtorsItem, required) ### Certification - `object` (enum, required) - Allowed values: `certification` - `name` (string, required) - `key` (string, required) - `certification_type` (enum, required) - Allowed values: `federal`, `self_certified` - `external_sources` (list of CertificationExternalSourcesItem, required) - `id` (string, optional) - `business_id` (string, optional) - `created_at` (datetime, optional) - `updated_at` (datetime, optional) - `entrance_date` (datetime, optional, nullable) - `exit_date` (datetime, optional, nullable) - `certification_id` (string, optional, nullable) ### Document - `object` (enum, required) - Allowed values: `document` - `id` (string, required) - `document_type` (string, required) — Type of document. Common values include: Initial_Filing, Certificate of Good Standing, Articles of Incorporation, Initial Filing (UCC1), Amendment (UCC3) - `filename` (string, required) — Name of the document file - `content_type` (string, required) — MIME type of the document - `size` (integer, required) — File size in bytes - `download_url` (string, required) — URL to download the document - `created_at` (datetime, required) - `source` (DocumentSource, optional) - `filing_date` (datetime, optional, nullable) - `metadata` (map from string to any, optional) — Additional document metadata ### Lien - `object` (enum, required) - Allowed values: `lien` - `type` (enum, required) — Type of lien - Allowed values: `ucc`, `state`, `federal`, `attachment`, `judgment` - `id` (string, required) - `business_id` (string, required) - `debtors` (list of LienDebtorsItem, required) - `secured_parties` (list of LienSecuredPartiesItem, required) - `file_number` (string, required, nullable) — Filing number for the lien - `state` (enum, required) — State where the lien was filed - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY` - `status` (enum, required) — Current status of the lien - Allowed values: `created`, `pending`, `open`, `closing`, `closed`, `unknown`, `filed`, `failed` - `filing_date` (date, required, nullable) — Date the lien was filed - `status_category` (enum, required) — Categorized status of the lien - Allowed values: `active`, `open`, `closed`, `terminated`, `processing`, `unknown`, `failed` - `owner_id` (string, required) — Polymorphic owner ID (typically business_id) - `owner_type` (string, required) — Polymorphic owner type (typically Business) - `documents` (list of Document, required) — Associated lien documents - `updated_date` (date, optional, nullable) — Date the lien was last updated - `lapse_date` (date, optional, nullable) — Date the lien lapses/expires - `collateral` (string, optional, nullable) — Description of collateral securing the lien - `collateral_type` (enum, optional, nullable) — Type of collateral - Allowed values: `Blanket`, `Collateral`, `Unknown`, `All Assets and Receivables`, `All Receivables`, `All Assets`, `Named Assets`, `Unavailable` - `negative_pledge` (boolean, optional) — Whether this is a negative pledge - `confirmation_number` (string, optional, nullable) - `loan_principal_amount_cents` (integer, optional, nullable) — Loan principal amount in cents - `source` (string, optional, nullable) — Source URL for the lien data - `packet_number` (string, optional, nullable) - `lien_termination` (map from string to any, optional, nullable) — Lien termination details if terminated - `liability_cents` (integer, optional, nullable) — Liability amount in cents - `alternative_designation` (enum, optional, nullable) - Allowed values: `buyer_seller`, `bailee_bailor`, `consignee_consignor`, `lessee_lessor`, `licensee_licensor` - `filed_by_account` (boolean, optional, nullable) — Whether the lien was filed by the account ### Name - `object` (string, required) - `id` (string, required) - `name` (string, required) - `submitted` (boolean, required) - `business_id` (string, required) - `sources` (list of Source, required) - `type` (enum, optional, nullable) - Allowed values: `legal`, `dba` ### Address - `object` (string, required) - `id` (string, required) - `full_address` (string, required) - `submitted` (boolean, required) - `created_at` (datetime, required) - `updated_at` (datetime, required) - `business_id` (string, required) - `sources` (list of Source, required) - `rating` (AddressRating, required) - `address_line1` (string, optional, nullable) - `address_line2` (string, optional, nullable) - `city` (string, optional, nullable) - `state` (enum, optional, nullable) - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY` - `postal_code` (string, optional, nullable) - `latitude` (double, optional, nullable) - `longitude` (double, optional, nullable) - `property_type` (enum, optional, nullable) - Allowed values: `commercial`, `residential` - `deliverable` (boolean, optional) - `deliverability_analysis` (AddressDeliverabilityAnalysis, optional, nullable) - `street_view_available` (boolean, optional, nullable) - `labels` (list of string, optional) - `references` (list of string, optional) — References submitted by the customer for this address. Only present when the customer submitted a reference; collapsed duplicate addresses include every submitted key. - `registered_agent_name` (string, optional, nullable) - `cmra` (boolean, optional) - `location_count` (integer, optional, nullable) - `is_registered_agent` (boolean, optional, nullable) ### Person - `object` (enum, optional) - Allowed values: `person` - `id` (string, optional) - `name` (string, optional) - `submitted` (boolean, optional) - `business_id` (string, optional) - `titles` (list of PersonTitlesItem, optional) - `people_bankruptcies` (list of map from string to any, optional) - `litigations` (list of Litigation, optional) - `liens` (list of Lien, optional) - `criminal_records` (list of CriminalHistoryRecord, optional) - `sources` (list of Source, optional) ### PhoneNumber - `object` (enum, optional) - Allowed values: `phone_number` - `id` (string, optional) — Unique identifier for the phone number resource. - `number` (string, optional) - `contact_type` (string, optional, nullable) - `recommended` (boolean, optional, nullable) ### EmailAddress - `object` (enum, required) - Allowed values: `email_address` - `id` (string, required) - `email` (string, required) - `submitted` (boolean, required) - `sources` (list of Source, optional) - `domain` (string, optional) — Domain portion of the email address. Included when email risk data is present. - `valid` (boolean, optional) — Whether the email address is valid. Included when email risk data is present. - `deliverability` (string, optional) — Likelihood that mail sent to this address will be delivered. Included when email risk data is present. - `disposable` (boolean, optional) — Whether the email belongs to a disposable / temporary email service. Included when email risk data is present. - `address_type` (enum, optional) — Classification of the email address. Included when email risk data is present. - Allowed values: `disposable`, `free`, `private` - `business_id` (string, optional) — ID of the business the email address is associated with. Included when email risk data is present. - `domain_age` (datetime, optional, nullable) — UTC datetime the email's domain was first registered. Included when email risk data is present. - `first_seen` (datetime, optional, nullable) — UTC datetime the email was first observed by our data provider. Included when email risk data is present. - `rating` (EmailRating, optional) ### Profile - `object` (string, required) - `id` (string, required) - `type` (enum, required) - Allowed values: `facebook`, `google`, `yelp`, `bbb`, `linkedin` - `url` (string, required) - `external_id` (string, optional, nullable) - `metadata` (ProfileMetadata, optional) - `rating` (double, optional, nullable) - `rating_count` (integer, optional, nullable) ### Registration - `object` (string, required) - `id` (string, required) - `business_id` (string, required) - `name` (string, required) - `status` (string, required) - `jurisdiction` (string, required, nullable) — Indicates the relationship between the business and this jurisdiction. `DOMESTIC` or `FOREIGN` for US registrations; `HOME` or `EXTRA_PROVINCIAL` for Canada; `UNKNOWN` when undetermined; `null` for other international registrations. - `entity_type` (string, required, nullable) - `file_number` (string, required) - `state` (enum, required, nullable) — The US state for the registration. `null` for international registrations. - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY` - `sub_status` (string, optional, nullable) - `status_details` (string, optional, nullable) - `jurisdiction_details` (RegistrationJurisdictionDetails, optional, nullable) — The sub-national jurisdiction for international registrations. `null` for US registrations. - `country_code` (string, optional) — `US` for domestic registrations, or an ISO 3166-1 alpha-2 code for international registrations (e.g., `FR`, `DE`, `GB`). - `addresses` (list of string, optional) - `officers` (list of map from string to any, optional) - `registered_agent` (map from string to any, optional, nullable) - `registration_date` (date, optional, nullable) - `source` (string, optional, nullable) - `submitted` (boolean, optional) — `true` if you submitted the registration, `false` if Middesk sourced it. ### Order - `object` (string, required) - `id` (string, required) - `status` (enum, required) - Allowed values: `created`, `pending`, `audited`, `completed`, `approved`, `rejected` - `business_id` (string, required) - `product` (enum, required) - Allowed values: `identity`, `liens`, `adverse_media`, `bankruptcies`, `business_enrichment`, `documents`, `enhanced_screenings`, `kyc`, `litigations`, `people_litigations`, `people_bankruptcies`, `people_tax_liens`, `people_ucc_liens`, `people_criminal_history`, `tin`, `website`, `business_verification_qualify`, `business_verification_verify`, `tax_liens`, `ucc_liens`, `email_risk` - `created_at` (datetime, required) - `updated_at` (datetime, required) - `subproducts` (list of enum, optional) - Allowed values: `Articles of Incorporation`, `Certificate of Good Standing`, `Articles of Incorporation with Certificate of Good Standing fallback`, `ucc_documents`, `web_analysis`, `industry_classification` - `completed_at` (datetime, optional, nullable) - `monitoring` (boolean, optional) - `requester` (OrderRequester, optional) ### IndustryClassification - `object` (enum, required) - Allowed values: `industry_classification` - `id` (string, required) - `status` (enum, required) - Allowed values: `pending`, `completed`, `failed` - `categories` (list of IndustryClassificationCategoriesItem, required) - `created_at` (datetime, required) - `completed_at` (datetime, optional, nullable) - `website` (IndustryClassificationWebsite, optional, nullable) ### Monitor - `object` (string, required) - `id` (string, required) - `created_at` (datetime, required) - `event_types` (list of MonitorEventTypesItem, required) ### TaxExemptOrganization - `object` (string, optional) - `id` (string, optional) - `ein` (string, optional) - `name` (string, optional) - `section` (string, optional, nullable) - `ruling_date` (date, optional, nullable) - `tax_period` (date, optional, nullable) - `revoked_at` (datetime, optional, nullable) ### FmcsaRegistration - `object` (enum, required) - Allowed values: `fmcsa_registration` - `id` (string, required) - `dot_number` (string, required) — Department of Transportation (DOT) number - `legal_name` (string, required) — Legal name of the carrier - `source` (string, required) — Source URL for the FMCSA registration data - `addresses` (list of string, required) — List of carrier addresses - `dba_name` (string, optional, nullable) — Doing Business As name ### Loan - `object` (enum, required) - Allowed values: `loan` - `id` (string, required) - `issued_date` (date, optional, nullable) - `amount` (double, optional, nullable) - `lender` (string, optional, nullable) - `details` (LoanDetails, optional, nullable) ### Litigation - `object` (string, required) - `id` (string, required) - `case_name` (string, required) - `case_number` (string, required) - `case_status` (enum, required) - Allowed values: `OPEN`, `CLOSED`, `UNKNOWN` - `case_type` (string, required) - `filing_date` (date, required) - `party_type` (string, required) - `judgments` (list of Judgment, optional) - `jurisdiction` (string, optional) - `jurisdiction_state` (string, optional, nullable) - `parties` (list of LitigationPartiesItem, optional) ### PolicyResult - `object` (string, optional) - `id` (string, optional) — Policy result ID - `result` (string, optional) — Policy result outcome - `created_at` (string, optional) — Creation timestamp - `matched` (string, optional, nullable) — Match status - `executed` (boolean, optional) — Execution status - `name` (string, optional, nullable) — Policy name - `details` (map from string to any, optional) — Additional details - `owner_id` (string, optional) — Owner ID - `owner_type` (string, optional) — Owner type - `business_id` (string, optional) — Business ID - `type_of` (string, optional) — Type of policy result - `policy_action_results` (list of PolicyActionResult, optional) ### PoliticallyExposedPersonScreening - `object` (string, required) - `id` (string, required) - `created_at` (datetime, required) - `updated_at` (datetime, required) - `results` (list of PoliticallyExposedPersonScreeningResultsItem, required) - `settings` (PoliticallyExposedPersonScreeningSettings, optional) ### AdverseMediaScreening - `object` (string, required) - `id` (string, required) - `created_at` (datetime, required) - `updated_at` (datetime, required) - `results` (list of AdverseMediaScreeningResultsItem, required) - `exclusion_settings` (AdverseMediaScreeningExclusionSettings, optional) ### Signal - `object` (string, required) - `id` (string, required) - `name` (string, required) - `created_at` (datetime, required) - `tin` (string, optional, nullable) - `external_id` (string, optional, nullable) - `model_slug` (string, optional) - `score` (double, optional, nullable) - `business_id` (string, optional, nullable) - `batch_id` (string, optional, nullable) - `requester` (SignalRequester, optional) - `reasons` (list of SignalReasonsItem, optional) - `addresses` (list of string, optional) - `people` (list of string, optional) ### SubmittedAttribute - `object` (string, required) - `name` (string, required) - `name_derived` (boolean, optional) - `entity_type` (string, optional, nullable) - `addresses` (list of map from string to any, optional) - `orders` (list of SubmittedAttributeOrdersItem, optional, nullable) - `people` (list of map from string to any, optional) - `phone_numbers` (list of map from string to any, optional, nullable) - `email_addresses` (list of map from string to any, optional, nullable) - `tags` (list of string, optional, nullable) - `external_id` (string, optional, nullable) - `unique_external_id` (string, optional, nullable) - `tin` (map from string to any, optional, nullable) - `website` (map from string to any, optional, nullable) - `assignee_id` (string, optional, nullable) - `formation` (map from string to any, optional, nullable) - `names` (list of map from string to any, optional, nullable) - `profiles` (list of map from string to any, optional, nullable) ### Subscription - `object` (string, optional) - `id` (string, optional) ### BusinessSubscriptionAvailability - `bankruptcy` (enum, optional) - Allowed values: `subscribable`, `account_unsubscribable` - `certification` (enum, optional) - Allowed values: `subscribable`, `account_unsubscribable` - `registration` (enum, optional) - Allowed values: `subscribable`, `account_unsubscribable` - `tin` (enum, optional) - Allowed values: `subscribable`, `account_unsubscribable` - `watchlist_result` (enum, optional) - Allowed values: `subscribable`, `account_unsubscribable` - `lien` (enum, optional) - Allowed values: `subscribable`, `account_unsubscribable` ### ErrorResponseErrorsItem - `message` (string, required) - `parameter` (string, optional) — Request parameter associated with the error, when applicable ### SubmittedAddressFull - `full_address` (string, required) — Complete address as a single string - `reference` (string, optional) — Optional, customer-supplied key to identify an address ### SubmittedAddressComponent - `address_line1` (string, required) - `city` (string, required) - `state` (enum, required) - Allowed values: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY` - `address_line2` (string, optional) - `postal_code` (string, optional) - `country` (string, optional) - `reference` (string, optional) — Optional, customer-supplied key to identify an address ### BusinessRequestParamOrdersItemOptions Per-order configuration flags. - `person_match` (boolean, optional) — When true on a `tin` order, enables person-name matching against IRS records. ### InternationalRegistrationRequestParamJurisdictionDetails The sub-national jurisdiction for the registration. - `abbr` (string, optional) — Abbreviation of the sub-national jurisdiction. Required when `country_code` is `CA`. ### ReviewTask - `category` (enum, required) - Allowed values: `bankruptcies`, `global_watchlists`, `name`, `people_litigations`, `loans`, `kyc`, `watchlist`, `phone`, `formation`, `people_criminal_history`, `adverse_media`, `litigations`, `tin_type`, `address`, `sos`, `web`, `liens`, `people_bankruptcies`, `industry`, `tin`, `people`, `people_liens`, `website`, `politically_exposed_persons`, `email` - `key` (enum, required) - Allowed values: `location_frequency`, `bankruptcies`, `sos_unknown`, `address_deliverability`, `website_url_discovery`, `entity_type`, `web_person_verification`, `global_watchlists`, `website_status`, `name`, `sos_sub_status`, `name_and_entity_type`, `sos_active`, `profile_status`, `phone`, `sos_domestic`, `address_high_risk`, `web_address_verification`, `address_property_type`, `sos_not_found`, `time_in_business`, `web_phone_number_verification`, `adverse_media`, `litigations`, `address_verification`, `people_litigations`, `dba_name`, `watchlist`, `entity_type_match`, `people_criminal_history`, `formation_state`, `tin_error`, `sos_inactive`, `address_frequency`, `web_business_name_verification`, `web_presence_quality`, `tin_type`, `tin_issued`, `sos_domestic_sub_status`, `risky_keywords`, `address_registered_agent`, `sos`, `kyc_decision`, `ppp_loans`, `web_email_address_verification`, `tin`, `address`, `liens`, `sos_status`, `industry`, `sos_match`, `address_risk`, `website_url_domain_ownership`, `website_parked`, `domain_redirect`, `people_bankruptcies`, `politically_exposed_persons`, `person_verification`, `profile_discovery`, `address_cmra`, `website_verification`, `website`, `people_liens`, `email_risk` - `label` (enum, required) - Allowed values: `Politically Exposed Persons`, `Web Presence Quality`, `KYC`, `People Bankruptcies`, `Address Risk`, `Global Watchlists`, `Phone Number`, `Third Party Profile Status`, `Liens`, `Third Party Profiles`, `Time in Business`, `Web - Email Address`, `Risky Keywords`, `SOS Domestic Sub‑status`, `PPP Loans`, `Secretary of State Filings`, `Entity Type`, `SOS Filings`, `People Criminal History`, `Adverse Media`, `Web - People`, `Office Address`, `Entity Type Match`, `Web - Phone Number`, `Business Name`, `Bankruptcies`, `Industry Classification`, `TIN Match`, `Watchlists`, `People Litigations`, `True Industry`, `People`, `DBA Name`, `Domain Ownership`, `Domain Redirect`, `TIN Type`, `Website`, `TIN Error`, `Watchlist`, `Litigations`, `Web - Business Name`, `Name Entity Type`, `Formation State`, `People Liens`, `Web - Office Address`, `Email Risk` - `message` (string, required) - `name` (string, required) - `status` (enum, required) - Allowed values: `success`, `failure`, `warning`, `neutral` - `sub_label` (string, required) - `sources` (list of Source, required) ### User - `object` (string, required) - `id` (string, required) - `name` (string, required) - `email` (string, required) - `roles` (list of string, required) - `created_at` (datetime, required) - `image_url` (string, optional) - `directory_managed` (boolean, optional) - `last_login_at` (datetime, optional, nullable) - `settings` (map from string to any, optional) ### Source - `id` (string, required) - `type` (string, required) — Origin of the resource. `risk_analysis` indicates the resource was discovered by a Risk order; for such sources, `id` is the originating risk_assessment ID. - `metadata` (map from string to any, required) ### WebsitePhoneNumber - `object` (enum, optional) - Allowed values: `phone_number` - `id` (string, optional) - `number` (string, optional) - `contact_type` (string, optional, nullable) - `recommended` (boolean, optional, nullable) - `submitted` (boolean, optional) - `sources` (list of Source, optional, nullable) ### WebsiteAddressesItem - `object` (string, optional) - `id` (string, optional) - `address_line1` (string, optional, nullable) - `address_line2` (string, optional, nullable) - `city` (string, optional, nullable) - `state` (string, optional, nullable) - `postal_code` (string, optional, nullable) - `full_address` (string, optional) - `submitted` (boolean, optional) - `sources` (list of Source, optional) ### WebsiteDomain - `domain` (string, optional) - `domain_id` (string, optional, nullable) - `creation_date` (datetime, optional) - `expiration_date` (datetime, optional) - `registrar` (WebsiteDomainRegistrar, optional) - `redirected` (boolean, optional, nullable) — Whether the domain redirects to a different URL - `url_shortener` (boolean, optional, nullable) — Whether the domain uses a URL shortener service - `resolved_url` (string, optional, nullable) — The final URL after redirect resolution (present when redirected is true) ### WebsitePagesItem - `url` (string, optional) - `category` (string, optional) - `screenshot_url` (string, optional) ### WebsiteEmailAddressesItem - `object` (enum, optional) - Allowed values: `email_address` - `email` (string, optional) - `id` (string, optional) - `submitted` (boolean, optional) - `sources` (list of Source, optional) ### WebsiteRating - `quality_rating` (enum, required) - Allowed values: `low`, `moderate`, `high`, `not_available` - `indicators` (list of WebsiteIndicator, optional) ### WatchlistAgency - `abbr` (string, required) - `name` (string, required) - `org` (string, required) ### WatchlistSource - `object` (string, required) - `agency` (string, required) - `agency_abbr` (string, required) - `organization` (string, required) - `title` (string, required) - `abbr` (string, required) - `results` (list of WatchlistResult, required) ### BankruptcyCaseUpdatesItem - `guid` (string, optional) - `pub_date` (string, optional) - `description` (string, optional) ### BankruptcyDebtorsItem - `name` (string, optional) ### CertificationExternalSourcesItem - `organization` (string, optional) - `link` (string, optional) ### DocumentSource - `type` (string, optional) — Source type (e.g., registration) - `id` (string, optional) — Source record ID - `metadata` (map from string to any, optional) — Additional source metadata ### LienDebtorsItem - `name` (string, optional) - `type` (enum, optional) - Allowed values: `ORGANIZATION`, `INDIVIDUAL`, `UNKNOWN`, `Business` - `party_type` (string, optional) - `organization_name` (string, optional) - `entity_type` (string, optional) - `first_name` (string, optional) - `last_name` (string, optional) - `addresses` (list of LienDebtorsItemAddressesItem, optional) ### LienSecuredPartiesItem - `name` (string, optional) - `type` (enum, optional) - Allowed values: `ORGANIZATION`, `INDIVIDUAL` - `role` (string, optional) - `organization_name` (string, optional) - `addresses` (list of LienSecuredPartiesItemAddressesItem, optional) ### AddressRating - `risk_rating` (enum, required) - Allowed values: `low`, `moderate`, `high`, `not_available` - `indicators` (list of AddressIndicator, optional) ### AddressDeliverabilityAnalysis - `message` (string, optional) - `sub_type` (enum, optional) - Allowed values: `Deliverable`, `Undeliverable`, `Unknown` - `sub_key` (enum, optional) - Allowed values: `deliverable`, `undeliverable`, `unknown` ### PersonTitlesItem - `object` (enum, optional) - Allowed values: `person_title` - `title` (string, optional) ### CriminalHistoryRecord - `object` (enum, required) - Allowed values: `criminal_history/record` - `id` (string, required) - `category` (string, required) - `cases` (list of CriminalHistoryCase, required) - `state` (string, optional, nullable) - `person` (CriminalHistoryRecordPerson, optional) ### EmailRating - `risk_rating` (enum, required) - Allowed values: `low`, `moderate`, `high` - `indicators` (list of EmailIndicator, optional) ### ProfileMetadata - `name` (string, optional) - `city` (string, optional) - `state` (string, optional) - `full_address` (string, optional) - `website_urls` (list of string, optional) - `latitude` (double, optional) - `longitude` (double, optional) - `phone_number` (string, optional) - `categories` (list of string, optional) - `reviews` (list of ProfileMetadataReviewsItem, optional) - `recent_posts` (list of map from string to any, optional) - `recent_reviews` (list of map from string to any, optional) ### RegistrationJurisdictionDetails The sub-national jurisdiction for international registrations. `null` for US registrations. - `name` (string, optional, nullable) - `abbr` (string, optional, nullable) - `authority` (string, optional, nullable) — The registry authority for the jurisdiction. ### OrderRequester - `name` (string, optional, nullable) - `type` (enum, optional, nullable) - Allowed values: `account`, `user`, `api_key` ### IndustryClassificationCategoriesItem - `classification_system` (enum, optional) - Allowed values: `NAICS`, `MCC`, `Prohibited` - `name` (string, optional) — Industry name - `sector` (string, optional, nullable) — Industry sector in CONSTANT_CASE - `category` (string, optional) — Industry category in CONSTANT_CASE - `score` (double, optional) — Classification confidence score (0.0 to 1.0) - `high_risk` (boolean, optional) — Whether this industry is considered high risk - `naics_codes` (list of string, optional) — NAICS (2022) classification codes - `sic_codes` (list of string, optional) — SIC classification codes - `mcc_codes` (list of string, optional) — MCC classification codes - `prohibited_labels` (list of string, optional, nullable) — Prohibited classification labels if applicable - `risk_program_flags` (list of RiskProgramFlag, optional) — Card-network merchant-risk program flags (Mastercard SMRP, Visa VIRP) this category was flagged under. Present on risk orders, and on website orders for accounts with card-network program flagging enabled; omitted otherwise. Empty when nothing was flagged. ### IndustryClassificationWebsite - `status` (enum, optional) - Allowed values: `online`, `offline`, `unknown` - `parked` (boolean, optional) ### MonitorEventTypesItem - `type` (string, optional) - `enabled_at` (datetime, optional, nullable) - `status` (enum, optional) - Allowed values: `active`, `unavailable`, `pending` ### LoanDetails - `gender` (string, optional, nullable) - `veteran` (string, optional, nullable) - `naics_code` (LoanDetailsNaicsCode, optional, nullable) - `non_profit` (string, optional, nullable) - `business_type` (string, optional, nullable) - `jobs_reported` (string, optional, nullable) - `race_ethnicity` (string, optional, nullable) ### Judgment - `id` (string, required) - `litigation_id` (string, required) - `docket_entry_date` (date, required) - `text` (string, required) - `created_at` (datetime, required) - `updated_at` (datetime, required) - `amount_cents` (integer, optional, nullable) — The judgment amount in cents. For example, 5000000 represents $50,000.00. Null if no monetary amount is associated with the judgment. ### LitigationPartiesItem - `id` (string, required) - `name` (string, required) - `role` (enum, required) - Allowed values: `Plaintiff`, `Defendant`, `Cross-Plaintiff`, `Cross-Defendant` - `litigation_id` (string, required) - `created_at` (datetime, optional) - `updated_at` (datetime, optional) ### PolicyActionResult - `object` (string, optional) - `id` (string, optional) — Policy action result ID - `details` (map from string to any, optional) — Action details - `executed` (boolean, optional) — Execution status - `policy_action` (PolicyActionResultPolicyAction, optional) ### PoliticallyExposedPersonScreeningResultsItem - `object` (enum, optional) - Allowed values: `politically_exposed_person_screening_result` - `id` (string, optional) - `aliases` (list of string, optional) - `birth_name` (string, optional, nullable) - `birth_place` (string, optional, nullable) - `citizenship_country` (string, optional, nullable) - `dob` (string, optional, nullable) - `employers` (list of string, optional) - `hit_type` (enum, optional) - Allowed values: `direct`, `direct_alias`, `association` - `memberships` (list of map from string to any, optional) - `name` (string, optional) - `professional_history` (list of string, optional) - `score` (double, optional) - `source_urls` (list of string, optional) - `stakeholders` (list of map from string to any, optional) ### PoliticallyExposedPersonScreeningSettings - `people` (string, optional) - `match_score` (enum, optional) - Allowed values: `LOW`, `MEDIUM`, `HIGH` ### AdverseMediaScreeningResultsItem - `object` (enum, optional) - Allowed values: `adverse_media_screening_result` - `id` (string, optional) - `risk_scores` (map from string to double, optional) - `created_at` (datetime, optional) - `updated_at` (datetime, optional) - `match_score` (double, optional) - `items` (list of AdverseMediaScreeningResultsItemItemsItem, optional) ### AdverseMediaScreeningExclusionSettings - `criteria_match_threshold` (double, optional) - `max_people_screened` (integer, optional) - `max_names_screened` (integer, optional) - `people` (list of map from string to any, optional) ### SignalRequester - `id` (string, required) - `type` (string, required) - `name` (string, required) ### SignalReasonsItem - `category` (enum, required) - Allowed values: `identification`, `verification`, `evaluation` - `group` (string, required) - `description` (string, required) - `code` (enum, required) - Allowed values: `I301`, `I302`, `I304`, `I102`, `I103`, `I107`, `I108`, `I109`, `I111`, `I601`, `I603`, `I201`, `I202`, `I203`, `I204`, `V010`, `V011`, `V101`, `V102`, `V103`, `V104`, `V501`, `V502`, `V503`, `V505`, `V748`, `V749`, `V750`, `V751`, `V752`, `V753`, `V801`, `V1101`, `V1201`, `V1302`, `E500`, `E501`, `E502`, `E503`, `E1101`, `E1102`, `E1201` - `importance` (double, optional) ### SubmittedAttributeOrdersItem - `product` (string, optional) ### WebsiteDomainRegistrar - `organization` (string, optional, nullable) - `name` (string, optional) - `url` (string, optional, nullable) ### WebsiteIndicator - `type` (enum, required) - Allowed values: `domain_age`, `top_level_domain`, `content_diversity`, `contact_info`, `compliance_info`, `page_count`, `broken_links`, `domain_consistency`, `update_frequency`, `filler_text`, `image_quality`, `last_updated`, `third_party_profile_links`, `us_business_presence`, `spelling_and_grammar`, `https`, `domain_ownership` - `name` (string, required) - `rating` (enum, required) - Allowed values: `positive`, `negative`, `neutral` - `value` (string, required) - `description` (string, required) ### WatchlistResult - `object` (enum, required) - Allowed values: `watchlist_result` - `id` (string, required) - `status` (string, required) - `entity_name` (string, required) - `entity_aliases` (list of string, required) - `agency_information_url` (string, required) - `agency_list_url` (string, required) - `score` (double, required, nullable) - `listed_at` (datetime, optional, nullable) - `addresses` (list of WatchlistResultAddressesItem, optional) - `url` (string, optional, nullable) - `list_country` (string, optional) - `list_url` (string, optional, nullable) - `list_region` (string, optional) - `categories` (list of string, optional) ### LienDebtorsItemAddressesItem - `full_address` (string, optional) - `address_line1` (string, optional) - `address_line2` (string, optional, nullable) - `city` (string, optional) - `state` (string, optional) - `postal_code` (string, optional) ### LienSecuredPartiesItemAddressesItem - `full_address` (string, optional) - `address_line1` (string, optional) - `address_line2` (string, optional, nullable) - `city` (string, optional) - `state` (string, optional) - `postal_code` (string, optional) ### AddressIndicator - `type` (enum, required) - Allowed values: `valid_us_address`, `deliverability`, `geographical_location`, `registered_agent`, `private_mailbox`, `location_frequency`, `property_type`, `virtual_address` - `name` (enum, required) - Allowed values: `Valid US address`, `Commercial registered agent`, `Geographical location`, `Private mailbox`, `Virtual address`, `Location frequency`, `Deliverability`, `Property type` - `rating` (enum, required) - Allowed values: `positive`, `negative`, `neutral` - `value` (string, required) - `description` (string, required) ### CriminalHistoryCase - `object` (enum, required) - Allowed values: `criminal_history/case` - `charges` (list of CriminalHistoryCharge, required) - `arrest_date` (date, optional, nullable) - `case_number` (string, optional, nullable) - `case_type` (string, optional, nullable) - `court_county` (string, optional, nullable) - `court_name` (string, optional, nullable) - `file_date` (date, optional, nullable) - `status` (string, optional, nullable) - `title` (string, optional, nullable) - `arresting_agency` (string, optional, nullable) ### CriminalHistoryRecordPerson - `dob` (date, optional, nullable) ### EmailIndicator - `type` (enum, required) - Allowed values: `email_validity`, `email_deliverability`, `email_domain_reputation`, `email_domain_configuration`, `email_account_activity`, `email_data_breach_exposure`, `email_address_type` - `name` (string, required) - `rating` (enum, required) - Allowed values: `positive`, `negative`, `neutral` - `value` (string, required) - `description` (string, required) ### ProfileMetadataReviewsItem - `rating` (double, optional) - `posted_at` (datetime, optional) ### RiskProgramFlag A card-network merchant-risk program the industry classification was flagged under. Present on risk orders, and on website orders for accounts with card-network program flagging enabled; enrichment only — never contributes to the risk score or level. - `program` (enum, required) — The card-network merchant-risk program. - Allowed values: `SMRP`, `VIRP` - `program_category` (string, required) — The network listing category (e.g. `crypto`, `pharmacy`, `gambling`). - `tier` (RiskProgramFlagTier, optional) — VIRP tier severity. Present only for VIRP flags; absent for SMRP (which is untiered). ### LoanDetailsNaicsCode - `code` (integer, optional) - `title` (string, optional) - `description` (string, optional) ### PolicyActionResultPolicyAction - `id` (string, optional) — Policy action ID - `action_type` (string, optional) — Type of action - `options` (map from string to any, optional) — Action options - `policy_version_id` (string, optional) — Policy version ID ### AdverseMediaScreeningResultsItemItemsItem - `object` (enum, optional) - Allowed values: `adverse_media_item` - `source_name` (string, optional) - `title` (string, optional) - `url` (string, optional) - `flags` (AdverseMediaScreeningResultsItemItemsItemFlags, optional) - `created_at` (datetime, optional) - `updated_at` (datetime, optional) ### WatchlistResultAddressesItem - `full_address` (string, optional) ### CriminalHistoryCharge - `object` (enum, required) - Allowed values: `criminal_history/charge` - `category` (string, optional, nullable) - `charge_type` (string, optional, nullable) - `city` (string, optional, nullable) - `county` (string, optional, nullable) - `description` (string, optional, nullable) - `dispositions` (list of CriminalHistoryChargeDispositionsItem, optional) - `legal_code` (string, optional, nullable) - `offense_date` (date, optional, nullable) - `sentences` (list of CriminalHistoryChargeSentencesItem, optional, nullable) - `state` (string, optional, nullable) - `subcategory` (string, optional, nullable) - `subsubcategory` (string, optional, nullable) ### RiskProgramFlagTier VIRP tier severity. Present only for VIRP flags; absent for SMRP (which is untiered). - `level` (integer, required) — VIRP tier severity level. - `harm_type` (enum, required) - Allowed values: `health_safety`, `financial`, `regulatory_deceptive` ### AdverseMediaScreeningResultsItemItemsItemFlags - `risks` (list of AdverseMediaScreeningResultsItemItemsItemFlagsRisksItem, optional) - `sentiments` (list of AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItem, optional) ### CriminalHistoryChargeDispositionsItem - `disposition` (string, optional, nullable) - `disposition_date` (date, optional, nullable) - `disposition_type` (string, optional, nullable) ### CriminalHistoryChargeSentencesItem - `details` (string, optional) ### AdverseMediaScreeningResultsItemItemsItemFlagsRisksItem - `name` (string, optional) - `confidence_level` (enum, optional) - Allowed values: `low`, `moderate`, `high` ### AdverseMediaScreeningResultsItemItemsItemFlagsSentimentsItem - `name` (enum, optional) - Allowed values: `positive`, `negative`, `neutral` - `confidence_level` (enum, optional) - Allowed values: `low`, `moderate`, `high` ## Examples ### Name Status Agent **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Agent import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Agent const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Agent package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Agent require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Agent import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Agent request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Agent using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Agent import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Corporation **Request** ```json { "name": "Corporation", "addresses": [ { "full_address": "321 Elm St, Austin, TX 78701" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Corporation import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Corporation", "addresses": [{ "full_address": "321 Elm St, Austin, TX 78701" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Corporation const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Corporation","addresses":[{"full_address":"321 Elm St, Austin, TX 78701"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Corporation package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Corporation\",\n \"addresses\": [\n {\n \"full_address\": \"321 Elm St, Austin, TX 78701\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Corporation require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Corporation\",\n \"addresses\": [\n {\n \"full_address\": \"321 Elm St, Austin, TX 78701\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Corporation import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Corporation\",\n \"addresses\": [\n {\n \"full_address\": \"321 Elm St, Austin, TX 78701\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Corporation request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Corporation", "addresses": [ { "full_address": "321 Elm St, Austin, TX 78701" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Corporation using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Corporation\",\n \"addresses\": [\n {\n \"full_address\": \"321 Elm St, Austin, TX 78701\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Corporation import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Corporation", "addresses": [["full_address": "321 Elm St, Austin, TX 78701"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status LinkedIn **Request** ```json { "name": "Business from LinkedIn", "addresses": [ { "full_address": "951 Sycamore Ave, Minneapolis, MN 55401" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status LinkedIn import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Business from LinkedIn", "addresses": [{ "full_address": "951 Sycamore Ave, Minneapolis, MN 55401" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status LinkedIn const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Business from LinkedIn","addresses":[{"full_address":"951 Sycamore Ave, Minneapolis, MN 55401"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status LinkedIn package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Business from LinkedIn\",\n \"addresses\": [\n {\n \"full_address\": \"951 Sycamore Ave, Minneapolis, MN 55401\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status LinkedIn require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Business from LinkedIn\",\n \"addresses\": [\n {\n \"full_address\": \"951 Sycamore Ave, Minneapolis, MN 55401\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status LinkedIn import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Business from LinkedIn\",\n \"addresses\": [\n {\n \"full_address\": \"951 Sycamore Ave, Minneapolis, MN 55401\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status LinkedIn request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Business from LinkedIn", "addresses": [ { "full_address": "951 Sycamore Ave, Minneapolis, MN 55401" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status LinkedIn using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Business from LinkedIn\",\n \"addresses\": [\n {\n \"full_address\": \"951 Sycamore Ave, Minneapolis, MN 55401\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status LinkedIn import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Business from LinkedIn", "addresses": [["full_address": "951 Sycamore Ave, Minneapolis, MN 55401"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status LLC **Request** ```json { "name": "LLC", "addresses": [ { "full_address": "741 Aspen Way, Atlanta, GA 30301" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status LLC import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "LLC", "addresses": [{ "full_address": "741 Aspen Way, Atlanta, GA 30301" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status LLC const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"LLC","addresses":[{"full_address":"741 Aspen Way, Atlanta, GA 30301"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status LLC package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"LLC\",\n \"addresses\": [\n {\n \"full_address\": \"741 Aspen Way, Atlanta, GA 30301\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status LLC require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"LLC\",\n \"addresses\": [\n {\n \"full_address\": \"741 Aspen Way, Atlanta, GA 30301\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status LLC import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"LLC\",\n \"addresses\": [\n {\n \"full_address\": \"741 Aspen Way, Atlanta, GA 30301\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status LLC request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "LLC", "addresses": [ { "full_address": "741 Aspen Way, Atlanta, GA 30301" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status LLC using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"LLC\",\n \"addresses\": [\n {\n \"full_address\": \"741 Aspen Way, Atlanta, GA 30301\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status LLC import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "LLC", "addresses": [["full_address": "741 Aspen Way, Atlanta, GA 30301"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Long Review **Request** ```json { "name": "Test Company with long analyst review", "addresses": [ { "full_address": "159 Redwood Pl, Las Vegas, NV 89101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Long Review import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company with long analyst review", "addresses": [{ "full_address": "159 Redwood Pl, Las Vegas, NV 89101" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Long Review const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company with long analyst review","addresses":[{"full_address":"159 Redwood Pl, Las Vegas, NV 89101"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Long Review package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company with long analyst review\",\n \"addresses\": [\n {\n \"full_address\": \"159 Redwood Pl, Las Vegas, NV 89101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Long Review require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company with long analyst review\",\n \"addresses\": [\n {\n \"full_address\": \"159 Redwood Pl, Las Vegas, NV 89101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Long Review import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company with long analyst review\",\n \"addresses\": [\n {\n \"full_address\": \"159 Redwood Pl, Las Vegas, NV 89101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Long Review request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company with long analyst review", "addresses": [ { "full_address": "159 Redwood Pl, Las Vegas, NV 89101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Long Review using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company with long analyst review\",\n \"addresses\": [\n {\n \"full_address\": \"159 Redwood Pl, Las Vegas, NV 89101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Long Review import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company with long analyst review", "addresses": [["full_address": "159 Redwood Pl, Las Vegas, NV 89101"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Non Profit **Request** ```json { "name": "Non Profit", "addresses": [ { "full_address": "258 Spruce Ave, Miami, FL 33101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Non Profit import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Non Profit", "addresses": [{ "full_address": "258 Spruce Ave, Miami, FL 33101" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Non Profit const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Non Profit","addresses":[{"full_address":"258 Spruce Ave, Miami, FL 33101"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Non Profit package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Non Profit\",\n \"addresses\": [\n {\n \"full_address\": \"258 Spruce Ave, Miami, FL 33101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Non Profit require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Non Profit\",\n \"addresses\": [\n {\n \"full_address\": \"258 Spruce Ave, Miami, FL 33101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Non Profit import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Non Profit\",\n \"addresses\": [\n {\n \"full_address\": \"258 Spruce Ave, Miami, FL 33101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Non Profit request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Non Profit", "addresses": [ { "full_address": "258 Spruce Ave, Miami, FL 33101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Non Profit using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Non Profit\",\n \"addresses\": [\n {\n \"full_address\": \"258 Spruce Ave, Miami, FL 33101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Non Profit import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Non Profit", "addresses": [["full_address": "258 Spruce Ave, Miami, FL 33101"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Partnership **Request** ```json { "name": "Partnership", "addresses": [ { "full_address": "654 Maple Dr, Denver, CO 80202" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Partnership import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Partnership", "addresses": [{ "full_address": "654 Maple Dr, Denver, CO 80202" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Partnership const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Partnership","addresses":[{"full_address":"654 Maple Dr, Denver, CO 80202"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Partnership package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Partnership\",\n \"addresses\": [\n {\n \"full_address\": \"654 Maple Dr, Denver, CO 80202\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Partnership require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Partnership\",\n \"addresses\": [\n {\n \"full_address\": \"654 Maple Dr, Denver, CO 80202\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Partnership import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Partnership\",\n \"addresses\": [\n {\n \"full_address\": \"654 Maple Dr, Denver, CO 80202\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Partnership request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Partnership", "addresses": [ { "full_address": "654 Maple Dr, Denver, CO 80202" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Partnership using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Partnership\",\n \"addresses\": [\n {\n \"full_address\": \"654 Maple Dr, Denver, CO 80202\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Partnership import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Partnership", "addresses": [["full_address": "654 Maple Dr, Denver, CO 80202"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Short Review **Request** ```json { "name": "Test Company with short analyst review", "addresses": [ { "full_address": "963 Cypress Ct, Nashville, TN 37201" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Short Review import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company with short analyst review", "addresses": [{ "full_address": "963 Cypress Ct, Nashville, TN 37201" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Short Review const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company with short analyst review","addresses":[{"full_address":"963 Cypress Ct, Nashville, TN 37201"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Short Review package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company with short analyst review\",\n \"addresses\": [\n {\n \"full_address\": \"963 Cypress Ct, Nashville, TN 37201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Short Review require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company with short analyst review\",\n \"addresses\": [\n {\n \"full_address\": \"963 Cypress Ct, Nashville, TN 37201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Short Review import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company with short analyst review\",\n \"addresses\": [\n {\n \"full_address\": \"963 Cypress Ct, Nashville, TN 37201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Short Review request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company with short analyst review", "addresses": [ { "full_address": "963 Cypress Ct, Nashville, TN 37201" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Short Review using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company with short analyst review\",\n \"addresses\": [\n {\n \"full_address\": \"963 Cypress Ct, Nashville, TN 37201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Short Review import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company with short analyst review", "addresses": [["full_address": "963 Cypress Ct, Nashville, TN 37201"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Sole Proprietorship **Request** ```json { "name": "Sole Proprietorship", "addresses": [ { "full_address": "987 Cedar Ln, Portland, OR 97201" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Sole Proprietorship import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Sole Proprietorship", "addresses": [{ "full_address": "987 Cedar Ln, Portland, OR 97201" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Sole Proprietorship const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Sole Proprietorship","addresses":[{"full_address":"987 Cedar Ln, Portland, OR 97201"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Sole Proprietorship package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Sole Proprietorship\",\n \"addresses\": [\n {\n \"full_address\": \"987 Cedar Ln, Portland, OR 97201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Sole Proprietorship require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Sole Proprietorship\",\n \"addresses\": [\n {\n \"full_address\": \"987 Cedar Ln, Portland, OR 97201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Sole Proprietorship import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Sole Proprietorship\",\n \"addresses\": [\n {\n \"full_address\": \"987 Cedar Ln, Portland, OR 97201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Sole Proprietorship request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Sole Proprietorship", "addresses": [ { "full_address": "987 Cedar Ln, Portland, OR 97201" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Sole Proprietorship using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Sole Proprietorship\",\n \"addresses\": [\n {\n \"full_address\": \"987 Cedar Ln, Portland, OR 97201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Sole Proprietorship import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Sole Proprietorship", "addresses": [["full_address": "987 Cedar Ln, Portland, OR 97201"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Trust **Request** ```json { "name": "Trust", "addresses": [ { "full_address": "147 Birch Rd, Boston, MA 02101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Trust import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Trust", "addresses": [{ "full_address": "147 Birch Rd, Boston, MA 02101" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Trust const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Trust","addresses":[{"full_address":"147 Birch Rd, Boston, MA 02101"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Trust package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Trust\",\n \"addresses\": [\n {\n \"full_address\": \"147 Birch Rd, Boston, MA 02101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Trust require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Trust\",\n \"addresses\": [\n {\n \"full_address\": \"147 Birch Rd, Boston, MA 02101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Trust import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Trust\",\n \"addresses\": [\n {\n \"full_address\": \"147 Birch Rd, Boston, MA 02101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Trust request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Trust", "addresses": [ { "full_address": "147 Birch Rd, Boston, MA 02101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Trust using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Trust\",\n \"addresses\": [\n {\n \"full_address\": \"147 Birch Rd, Boston, MA 02101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Trust import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Trust", "addresses": [["full_address": "147 Birch Rd, Boston, MA 02101"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Unverified **Request** ```json { "name": "Unverified Name Business", "addresses": [ { "full_address": "789 Pine St, Seattle, WA 98101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Unverified import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Unverified Name Business", "addresses": [{ "full_address": "789 Pine St, Seattle, WA 98101" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Unverified const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Unverified Name Business","addresses":[{"full_address":"789 Pine St, Seattle, WA 98101"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Unverified package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Unverified Name Business\",\n \"addresses\": [\n {\n \"full_address\": \"789 Pine St, Seattle, WA 98101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Unverified require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Unverified Name Business\",\n \"addresses\": [\n {\n \"full_address\": \"789 Pine St, Seattle, WA 98101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Unverified import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Unverified Name Business\",\n \"addresses\": [\n {\n \"full_address\": \"789 Pine St, Seattle, WA 98101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Unverified request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Unverified Name Business", "addresses": [ { "full_address": "789 Pine St, Seattle, WA 98101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Unverified using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Unverified Name Business\",\n \"addresses\": [\n {\n \"full_address\": \"789 Pine St, Seattle, WA 98101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Unverified import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Unverified Name Business", "addresses": [["full_address": "789 Pine St, Seattle, WA 98101"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Website **Request** ```json { "name": "Business from Website", "addresses": [ { "full_address": "753 Magnolia St, Detroit, MI 48201" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Website import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Business from Website", "addresses": [{ "full_address": "753 Magnolia St, Detroit, MI 48201" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Website const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Business from Website","addresses":[{"full_address":"753 Magnolia St, Detroit, MI 48201"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Website package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Business from Website\",\n \"addresses\": [\n {\n \"full_address\": \"753 Magnolia St, Detroit, MI 48201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Website require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Business from Website\",\n \"addresses\": [\n {\n \"full_address\": \"753 Magnolia St, Detroit, MI 48201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Website import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Business from Website\",\n \"addresses\": [\n {\n \"full_address\": \"753 Magnolia St, Detroit, MI 48201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Website request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Business from Website", "addresses": [ { "full_address": "753 Magnolia St, Detroit, MI 48201" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Website using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Business from Website\",\n \"addresses\": [\n {\n \"full_address\": \"753 Magnolia St, Detroit, MI 48201\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Website import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Business from Website", "addresses": [["full_address": "753 Magnolia St, Detroit, MI 48201"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Website Order URL Only **Request** ```json { "name": "name", "addresses": [ { "full_address": "full_address" } ], "website": { "url": "https://www.example.com" }, "orders": [ { "product": "website", "subproducts": [ "web_analysis", "industry_classification" ] } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Website Order URL Only import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "name", "addresses": [{ "full_address": "full_address" }], "website": { "url": "https://www.example.com" }, "orders": [ { "product": "website", "subproducts": ["web_analysis", "industry_classification"] } ] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Website Order URL Only const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"name","addresses":[{"full_address":"full_address"}],"website":{"url":"https://www.example.com"},"orders":[{"product":"website","subproducts":["web_analysis","industry_classification"]}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Website Order URL Only package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"name\",\n \"addresses\": [\n {\n \"full_address\": \"full_address\"\n }\n ],\n \"website\": {\n \"url\": \"https://www.example.com\"\n },\n \"orders\": [\n {\n \"product\": \"website\",\n \"subproducts\": [\n \"web_analysis\",\n \"industry_classification\"\n ]\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Website Order URL Only require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"name\",\n \"addresses\": [\n {\n \"full_address\": \"full_address\"\n }\n ],\n \"website\": {\n \"url\": \"https://www.example.com\"\n },\n \"orders\": [\n {\n \"product\": \"website\",\n \"subproducts\": [\n \"web_analysis\",\n \"industry_classification\"\n ]\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Website Order URL Only import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"name\",\n \"addresses\": [\n {\n \"full_address\": \"full_address\"\n }\n ],\n \"website\": {\n \"url\": \"https://www.example.com\"\n },\n \"orders\": [\n {\n \"product\": \"website\",\n \"subproducts\": [\n \"web_analysis\",\n \"industry_classification\"\n ]\n }\n ]\n}") .asString(); ``` ```php Website Order URL Only request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "name", "addresses": [ { "full_address": "full_address" } ], "website": { "url": "https://www.example.com" }, "orders": [ { "product": "website", "subproducts": [ "web_analysis", "industry_classification" ] } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Website Order URL Only using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"name\",\n \"addresses\": [\n {\n \"full_address\": \"full_address\"\n }\n ],\n \"website\": {\n \"url\": \"https://www.example.com\"\n },\n \"orders\": [\n {\n \"product\": \"website\",\n \"subproducts\": [\n \"web_analysis\",\n \"industry_classification\"\n ]\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Website Order URL Only import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "name", "addresses": [["full_address": "full_address"]], "website": ["url": "https://www.example.com"], "orders": [ [ "product": "website", "subproducts": ["web_analysis", "industry_classification"] ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name Status Young **Request** ```json { "name": "Young Business", "addresses": [ { "full_address": "852 Palm Blvd, San Diego, CA 92101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name Status Young import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Young Business", "addresses": [{ "full_address": "852 Palm Blvd, San Diego, CA 92101" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name Status Young const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Young Business","addresses":[{"full_address":"852 Palm Blvd, San Diego, CA 92101"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name Status Young package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Young Business\",\n \"addresses\": [\n {\n \"full_address\": \"852 Palm Blvd, San Diego, CA 92101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name Status Young require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Young Business\",\n \"addresses\": [\n {\n \"full_address\": \"852 Palm Blvd, San Diego, CA 92101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name Status Young import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Young Business\",\n \"addresses\": [\n {\n \"full_address\": \"852 Palm Blvd, San Diego, CA 92101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name Status Young request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Young Business", "addresses": [ { "full_address": "852 Palm Blvd, San Diego, CA 92101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name Status Young using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Young Business\",\n \"addresses\": [\n {\n \"full_address\": \"852 Palm Blvd, San Diego, CA 92101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name Status Young import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Young Business", "addresses": [["full_address": "852 Palm Blvd, San Diego, CA 92101"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### SOS Status Inactive **Request** ```json { "name": "Domestic Inactive", "addresses": [ { "full_address": "200 Broadway, New York, NY 10007" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python SOS Status Inactive import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Domestic Inactive", "addresses": [{ "full_address": "200 Broadway, New York, NY 10007" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript SOS Status Inactive const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Domestic Inactive","addresses":[{"full_address":"200 Broadway, New York, NY 10007"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go SOS Status Inactive package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Domestic Inactive\",\n \"addresses\": [\n {\n \"full_address\": \"200 Broadway, New York, NY 10007\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby SOS Status Inactive require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Domestic Inactive\",\n \"addresses\": [\n {\n \"full_address\": \"200 Broadway, New York, NY 10007\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java SOS Status Inactive import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Domestic Inactive\",\n \"addresses\": [\n {\n \"full_address\": \"200 Broadway, New York, NY 10007\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php SOS Status Inactive request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Domestic Inactive", "addresses": [ { "full_address": "200 Broadway, New York, NY 10007" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp SOS Status Inactive using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Domestic Inactive\",\n \"addresses\": [\n {\n \"full_address\": \"200 Broadway, New York, NY 10007\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift SOS Status Inactive import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Domestic Inactive", "addresses": [["full_address": "200 Broadway, New York, NY 10007"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### SOS Status Missing **Request** ```json { "name": "Domestic Missing", "addresses": [ { "full_address": "100 Market St, San Francisco, CA 94105" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python SOS Status Missing import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Domestic Missing", "addresses": [{ "full_address": "100 Market St, San Francisco, CA 94105" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript SOS Status Missing const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Domestic Missing","addresses":[{"full_address":"100 Market St, San Francisco, CA 94105"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go SOS Status Missing package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Domestic Missing\",\n \"addresses\": [\n {\n \"full_address\": \"100 Market St, San Francisco, CA 94105\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby SOS Status Missing require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Domestic Missing\",\n \"addresses\": [\n {\n \"full_address\": \"100 Market St, San Francisco, CA 94105\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java SOS Status Missing import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Domestic Missing\",\n \"addresses\": [\n {\n \"full_address\": \"100 Market St, San Francisco, CA 94105\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php SOS Status Missing request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Domestic Missing", "addresses": [ { "full_address": "100 Market St, San Francisco, CA 94105" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp SOS Status Missing using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Domestic Missing\",\n \"addresses\": [\n {\n \"full_address\": \"100 Market St, San Francisco, CA 94105\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift SOS Status Missing import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Domestic Missing", "addresses": [["full_address": "100 Market St, San Francisco, CA 94105"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### SOS Status Partial Inactive **Request** ```json { "name": "Partial Inactive", "addresses": [ { "full_address": "400 Pike St, Seattle, WA 98101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python SOS Status Partial Inactive import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Partial Inactive", "addresses": [{ "full_address": "400 Pike St, Seattle, WA 98101" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript SOS Status Partial Inactive const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Partial Inactive","addresses":[{"full_address":"400 Pike St, Seattle, WA 98101"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go SOS Status Partial Inactive package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Partial Inactive\",\n \"addresses\": [\n {\n \"full_address\": \"400 Pike St, Seattle, WA 98101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby SOS Status Partial Inactive require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Partial Inactive\",\n \"addresses\": [\n {\n \"full_address\": \"400 Pike St, Seattle, WA 98101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java SOS Status Partial Inactive import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Partial Inactive\",\n \"addresses\": [\n {\n \"full_address\": \"400 Pike St, Seattle, WA 98101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php SOS Status Partial Inactive request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Partial Inactive", "addresses": [ { "full_address": "400 Pike St, Seattle, WA 98101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp SOS Status Partial Inactive using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Partial Inactive\",\n \"addresses\": [\n {\n \"full_address\": \"400 Pike St, Seattle, WA 98101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift SOS Status Partial Inactive import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Partial Inactive", "addresses": [["full_address": "400 Pike St, Seattle, WA 98101"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### SOS Status Unknown **Request** ```json { "name": "Domestic Unknown", "addresses": [ { "full_address": "300 Congress Ave, Austin, TX 78701" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python SOS Status Unknown import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Domestic Unknown", "addresses": [{ "full_address": "300 Congress Ave, Austin, TX 78701" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript SOS Status Unknown const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Domestic Unknown","addresses":[{"full_address":"300 Congress Ave, Austin, TX 78701"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go SOS Status Unknown package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Domestic Unknown\",\n \"addresses\": [\n {\n \"full_address\": \"300 Congress Ave, Austin, TX 78701\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby SOS Status Unknown require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Domestic Unknown\",\n \"addresses\": [\n {\n \"full_address\": \"300 Congress Ave, Austin, TX 78701\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java SOS Status Unknown import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Domestic Unknown\",\n \"addresses\": [\n {\n \"full_address\": \"300 Congress Ave, Austin, TX 78701\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php SOS Status Unknown request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Domestic Unknown", "addresses": [ { "full_address": "300 Congress Ave, Austin, TX 78701" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp SOS Status Unknown using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Domestic Unknown\",\n \"addresses\": [\n {\n \"full_address\": \"300 Congress Ave, Austin, TX 78701\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift SOS Status Unknown import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Domestic Unknown", "addresses": [["full_address": "300 Congress Ave, Austin, TX 78701"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address Status Approximate **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "423 Grand St., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address Status Approximate import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "423 Grand St., New York, NY 10013" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address Status Approximate const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"423 Grand St., New York, NY 10013"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address Status Approximate package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"423 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address Status Approximate require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"423 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address Status Approximate import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"423 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address Status Approximate request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "423 Grand St., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address Status Approximate using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"423 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address Status Approximate import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "423 Grand St., New York, NY 10013"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address Status CMRA **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "991 cmra st., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address Status CMRA import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "991 cmra st., New York, NY 10013" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address Status CMRA const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"991 cmra st., New York, NY 10013"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address Status CMRA package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 cmra st., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address Status CMRA require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 cmra st., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address Status CMRA import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 cmra st., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address Status CMRA request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "991 cmra st., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address Status CMRA using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 cmra st., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address Status CMRA import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "991 cmra st., New York, NY 10013"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address Status Incomplete **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "New York, NY" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address Status Incomplete import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "New York, NY" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address Status Incomplete const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"New York, NY"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address Status Incomplete package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"New York, NY\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address Status Incomplete require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"New York, NY\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address Status Incomplete import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"New York, NY\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address Status Incomplete request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "New York, NY" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address Status Incomplete using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"New York, NY\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address Status Incomplete import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "New York, NY"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address Status No Match **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "123 Grand St., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address Status No Match import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "123 Grand St., New York, NY 10013" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address Status No Match const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"123 Grand St., New York, NY 10013"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address Status No Match package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"123 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address Status No Match require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"123 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address Status No Match import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"123 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address Status No Match request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "123 Grand St., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address Status No Match using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"123 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address Status No Match import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "123 Grand St., New York, NY 10013"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address Status Registered Agent **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "991 registered agent st., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address Status Registered Agent import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "991 registered agent st., New York, NY 10013" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address Status Registered Agent const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"991 registered agent st., New York, NY 10013"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address Status Registered Agent package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 registered agent st., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address Status Registered Agent require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 registered agent st., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address Status Registered Agent import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 registered agent st., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address Status Registered Agent request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "991 registered agent st., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address Status Registered Agent using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 registered agent st., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address Status Registered Agent import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "991 registered agent st., New York, NY 10013"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address Status Similar **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "223 Grand St., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address Status Similar import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "223 Grand St., New York, NY 10013" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address Status Similar const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"223 Grand St., New York, NY 10013"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address Status Similar package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"223 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address Status Similar require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"223 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address Status Similar import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"223 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address Status Similar request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "223 Grand St., New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address Status Similar using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"223 Grand St., New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address Status Similar import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "223 Grand St., New York, NY 10013"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address Status Undeliverable **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "991 st. undeliverable, New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address Status Undeliverable import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "991 st. undeliverable, New York, NY 10013" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address Status Undeliverable const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"991 st. undeliverable, New York, NY 10013"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address Status Undeliverable package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 st. undeliverable, New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address Status Undeliverable require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 st. undeliverable, New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address Status Undeliverable import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 st. undeliverable, New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address Status Undeliverable request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "991 st. undeliverable, New York, NY 10013" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address Status Undeliverable using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"991 st. undeliverable, New York, NY 10013\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address Status Undeliverable import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "991 st. undeliverable, New York, NY 10013"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Entity Type Corporation Mismatch **Request** ```json { "name": "Test Corporation Inc", "addresses": [ { "full_address": "500 Main St, Chicago, IL 60601" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Entity Type Corporation Mismatch import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Corporation Inc", "addresses": [{ "full_address": "500 Main St, Chicago, IL 60601" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Entity Type Corporation Mismatch const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Corporation Inc","addresses":[{"full_address":"500 Main St, Chicago, IL 60601"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Entity Type Corporation Mismatch package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Corporation Inc\",\n \"addresses\": [\n {\n \"full_address\": \"500 Main St, Chicago, IL 60601\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Entity Type Corporation Mismatch require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Corporation Inc\",\n \"addresses\": [\n {\n \"full_address\": \"500 Main St, Chicago, IL 60601\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Entity Type Corporation Mismatch import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Corporation Inc\",\n \"addresses\": [\n {\n \"full_address\": \"500 Main St, Chicago, IL 60601\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Entity Type Corporation Mismatch request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Corporation Inc", "addresses": [ { "full_address": "500 Main St, Chicago, IL 60601" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Entity Type Corporation Mismatch using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Corporation Inc\",\n \"addresses\": [\n {\n \"full_address\": \"500 Main St, Chicago, IL 60601\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Entity Type Corporation Mismatch import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Corporation Inc", "addresses": [["full_address": "500 Main St, Chicago, IL 60601"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Entity Type LLC Match **Request** ```json { "name": "Test LLC", "addresses": [ { "full_address": "600 State St, Boston, MA 02109" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Entity Type LLC Match import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test LLC", "addresses": [{ "full_address": "600 State St, Boston, MA 02109" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Entity Type LLC Match const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test LLC","addresses":[{"full_address":"600 State St, Boston, MA 02109"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Entity Type LLC Match package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test LLC\",\n \"addresses\": [\n {\n \"full_address\": \"600 State St, Boston, MA 02109\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Entity Type LLC Match require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test LLC\",\n \"addresses\": [\n {\n \"full_address\": \"600 State St, Boston, MA 02109\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Entity Type LLC Match import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test LLC\",\n \"addresses\": [\n {\n \"full_address\": \"600 State St, Boston, MA 02109\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Entity Type LLC Match request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test LLC", "addresses": [ { "full_address": "600 State St, Boston, MA 02109" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Entity Type LLC Match using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test LLC\",\n \"addresses\": [\n {\n \"full_address\": \"600 State St, Boston, MA 02109\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Entity Type LLC Match import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test LLC", "addresses": [["full_address": "600 State St, Boston, MA 02109"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### TIN Status IRS Unavailable **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "1300 Birch Rd, Houston, TX 77001" } ], "tin": { "tin": "333444555" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python TIN Status IRS Unavailable import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "1300 Birch Rd, Houston, TX 77001" }], "tin": { "tin": "333444555" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript TIN Status IRS Unavailable const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"1300 Birch Rd, Houston, TX 77001"}],"tin":{"tin":"333444555"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go TIN Status IRS Unavailable package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"1300 Birch Rd, Houston, TX 77001\"\n }\n ],\n \"tin\": {\n \"tin\": \"333444555\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby TIN Status IRS Unavailable require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"1300 Birch Rd, Houston, TX 77001\"\n }\n ],\n \"tin\": {\n \"tin\": \"333444555\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java TIN Status IRS Unavailable import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"1300 Birch Rd, Houston, TX 77001\"\n }\n ],\n \"tin\": {\n \"tin\": \"333444555\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php TIN Status IRS Unavailable request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "1300 Birch Rd, Houston, TX 77001" } ], "tin": { "tin": "333444555" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp TIN Status IRS Unavailable using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"1300 Birch Rd, Houston, TX 77001\"\n }\n ],\n \"tin\": {\n \"tin\": \"333444555\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift TIN Status IRS Unavailable import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "1300 Birch Rd, Houston, TX 77001"]], "tin": ["tin": "333444555"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### TIN Status Matches Person **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "1000 Elm St, Atlanta, GA 30301" } ], "tin": { "tin": "222333444" }, "people": [ { "name": "Jane Match" } ], "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python TIN Status Matches Person import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "1000 Elm St, Atlanta, GA 30301" }], "tin": { "tin": "222333444" }, "people": [{ "name": "Jane Match" }], "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript TIN Status Matches Person const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"1000 Elm St, Atlanta, GA 30301"}],"tin":{"tin":"222333444"},"people":[{"name":"Jane Match"}],"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go TIN Status Matches Person package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"1000 Elm St, Atlanta, GA 30301\"\n }\n ],\n \"tin\": {\n \"tin\": \"222333444\"\n },\n \"people\": [\n {\n \"name\": \"Jane Match\"\n }\n ],\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby TIN Status Matches Person require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"1000 Elm St, Atlanta, GA 30301\"\n }\n ],\n \"tin\": {\n \"tin\": \"222333444\"\n },\n \"people\": [\n {\n \"name\": \"Jane Match\"\n }\n ],\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java TIN Status Matches Person import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"1000 Elm St, Atlanta, GA 30301\"\n }\n ],\n \"tin\": {\n \"tin\": \"222333444\"\n },\n \"people\": [\n {\n \"name\": \"Jane Match\"\n }\n ],\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php TIN Status Matches Person request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "1000 Elm St, Atlanta, GA 30301" } ], "tin": { "tin": "222333444" }, "people": [ { "name": "Jane Match" } ], "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp TIN Status Matches Person using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"1000 Elm St, Atlanta, GA 30301\"\n }\n ],\n \"tin\": {\n \"tin\": \"222333444\"\n },\n \"people\": [\n {\n \"name\": \"Jane Match\"\n }\n ],\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift TIN Status Matches Person import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "1000 Elm St, Atlanta, GA 30301"]], "tin": ["tin": "222333444"], "people": [["name": "Jane Match"]], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### TIN Status Name Mismatch **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "700 Market St, Portland, OR 97201" } ], "tin": { "tin": "110000099" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python TIN Status Name Mismatch import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "700 Market St, Portland, OR 97201" }], "tin": { "tin": "110000099" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript TIN Status Name Mismatch const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"700 Market St, Portland, OR 97201"}],"tin":{"tin":"110000099"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go TIN Status Name Mismatch package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"700 Market St, Portland, OR 97201\"\n }\n ],\n \"tin\": {\n \"tin\": \"110000099\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby TIN Status Name Mismatch require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"700 Market St, Portland, OR 97201\"\n }\n ],\n \"tin\": {\n \"tin\": \"110000099\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java TIN Status Name Mismatch import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"700 Market St, Portland, OR 97201\"\n }\n ],\n \"tin\": {\n \"tin\": \"110000099\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php TIN Status Name Mismatch request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "700 Market St, Portland, OR 97201" } ], "tin": { "tin": "110000099" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp TIN Status Name Mismatch using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"700 Market St, Portland, OR 97201\"\n }\n ],\n \"tin\": {\n \"tin\": \"110000099\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift TIN Status Name Mismatch import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "700 Market St, Portland, OR 97201"]], "tin": ["tin": "110000099"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### TIN Status Type SSN **Request** ```json { "name": "Test Company SSN", "addresses": [ { "full_address": "1100 Maple Dr, Phoenix, AZ 85001" } ], "tin": { "tin": "555666777" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python TIN Status Type SSN import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company SSN", "addresses": [{ "full_address": "1100 Maple Dr, Phoenix, AZ 85001" }], "tin": { "tin": "555666777" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript TIN Status Type SSN const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company SSN","addresses":[{"full_address":"1100 Maple Dr, Phoenix, AZ 85001"}],"tin":{"tin":"555666777"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go TIN Status Type SSN package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company SSN\",\n \"addresses\": [\n {\n \"full_address\": \"1100 Maple Dr, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"555666777\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby TIN Status Type SSN require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company SSN\",\n \"addresses\": [\n {\n \"full_address\": \"1100 Maple Dr, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"555666777\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java TIN Status Type SSN import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company SSN\",\n \"addresses\": [\n {\n \"full_address\": \"1100 Maple Dr, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"555666777\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php TIN Status Type SSN request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company SSN", "addresses": [ { "full_address": "1100 Maple Dr, Phoenix, AZ 85001" } ], "tin": { "tin": "555666777" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp TIN Status Type SSN using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company SSN\",\n \"addresses\": [\n {\n \"full_address\": \"1100 Maple Dr, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"555666777\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift TIN Status Type SSN import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company SSN", "addresses": [["full_address": "1100 Maple Dr, Phoenix, AZ 85001"]], "tin": ["tin": "555666777"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### TIN Status Type SSN and EIN **Request** ```json { "name": "Test Company SSN and EIN", "addresses": [ { "full_address": "1200 Cedar Ln, Dallas, TX 75201" } ], "tin": { "tin": "666777888" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python TIN Status Type SSN and EIN import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company SSN and EIN", "addresses": [{ "full_address": "1200 Cedar Ln, Dallas, TX 75201" }], "tin": { "tin": "666777888" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript TIN Status Type SSN and EIN const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company SSN and EIN","addresses":[{"full_address":"1200 Cedar Ln, Dallas, TX 75201"}],"tin":{"tin":"666777888"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go TIN Status Type SSN and EIN package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company SSN and EIN\",\n \"addresses\": [\n {\n \"full_address\": \"1200 Cedar Ln, Dallas, TX 75201\"\n }\n ],\n \"tin\": {\n \"tin\": \"666777888\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby TIN Status Type SSN and EIN require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company SSN and EIN\",\n \"addresses\": [\n {\n \"full_address\": \"1200 Cedar Ln, Dallas, TX 75201\"\n }\n ],\n \"tin\": {\n \"tin\": \"666777888\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java TIN Status Type SSN and EIN import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company SSN and EIN\",\n \"addresses\": [\n {\n \"full_address\": \"1200 Cedar Ln, Dallas, TX 75201\"\n }\n ],\n \"tin\": {\n \"tin\": \"666777888\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php TIN Status Type SSN and EIN request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company SSN and EIN", "addresses": [ { "full_address": "1200 Cedar Ln, Dallas, TX 75201" } ], "tin": { "tin": "666777888" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp TIN Status Type SSN and EIN using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company SSN and EIN\",\n \"addresses\": [\n {\n \"full_address\": \"1200 Cedar Ln, Dallas, TX 75201\"\n }\n ],\n \"tin\": {\n \"tin\": \"666777888\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift TIN Status Type SSN and EIN import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company SSN and EIN", "addresses": [["full_address": "1200 Cedar Ln, Dallas, TX 75201"]], "tin": ["tin": "666777888"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### TIN Status Unknown Issued **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "800 Pine St, Denver, CO 80202" } ], "tin": { "tin": "111222333" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python TIN Status Unknown Issued import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "800 Pine St, Denver, CO 80202" }], "tin": { "tin": "111222333" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript TIN Status Unknown Issued const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"800 Pine St, Denver, CO 80202"}],"tin":{"tin":"111222333"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go TIN Status Unknown Issued package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"800 Pine St, Denver, CO 80202\"\n }\n ],\n \"tin\": {\n \"tin\": \"111222333\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby TIN Status Unknown Issued require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"800 Pine St, Denver, CO 80202\"\n }\n ],\n \"tin\": {\n \"tin\": \"111222333\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java TIN Status Unknown Issued import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"800 Pine St, Denver, CO 80202\"\n }\n ],\n \"tin\": {\n \"tin\": \"111222333\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php TIN Status Unknown Issued request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "800 Pine St, Denver, CO 80202" } ], "tin": { "tin": "111222333" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp TIN Status Unknown Issued using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"800 Pine St, Denver, CO 80202\"\n }\n ],\n \"tin\": {\n \"tin\": \"111222333\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift TIN Status Unknown Issued import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "800 Pine St, Denver, CO 80202"]], "tin": ["tin": "111222333"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### TIN Status Unknown Not Issued **Request** ```json { "name": "Test Company", "addresses": [ { "full_address": "900 Oak Ave, Miami, FL 33101" } ], "tin": { "tin": "444555666" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python TIN Status Unknown Not Issued import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company", "addresses": [{ "full_address": "900 Oak Ave, Miami, FL 33101" }], "tin": { "tin": "444555666" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript TIN Status Unknown Not Issued const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company","addresses":[{"full_address":"900 Oak Ave, Miami, FL 33101"}],"tin":{"tin":"444555666"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go TIN Status Unknown Not Issued package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"900 Oak Ave, Miami, FL 33101\"\n }\n ],\n \"tin\": {\n \"tin\": \"444555666\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby TIN Status Unknown Not Issued require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"900 Oak Ave, Miami, FL 33101\"\n }\n ],\n \"tin\": {\n \"tin\": \"444555666\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java TIN Status Unknown Not Issued import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"900 Oak Ave, Miami, FL 33101\"\n }\n ],\n \"tin\": {\n \"tin\": \"444555666\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php TIN Status Unknown Not Issued request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company", "addresses": [ { "full_address": "900 Oak Ave, Miami, FL 33101" } ], "tin": { "tin": "444555666" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp TIN Status Unknown Not Issued using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company\",\n \"addresses\": [\n {\n \"full_address\": \"900 Oak Ave, Miami, FL 33101\"\n }\n ],\n \"tin\": {\n \"tin\": \"444555666\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift TIN Status Unknown Not Issued import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company", "addresses": [["full_address": "900 Oak Ave, Miami, FL 33101"]], "tin": ["tin": "444555666"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Watchlist Hit **Request** ```json { "name": "Test Company watchlist hit", "addresses": [ { "full_address": "1400 Spruce Ave, Philadelphia, PA 19101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Watchlist Hit import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Test Company watchlist hit", "addresses": [{ "full_address": "1400 Spruce Ave, Philadelphia, PA 19101" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Watchlist Hit const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Test Company watchlist hit","addresses":[{"full_address":"1400 Spruce Ave, Philadelphia, PA 19101"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Watchlist Hit package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Test Company watchlist hit\",\n \"addresses\": [\n {\n \"full_address\": \"1400 Spruce Ave, Philadelphia, PA 19101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Watchlist Hit require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Test Company watchlist hit\",\n \"addresses\": [\n {\n \"full_address\": \"1400 Spruce Ave, Philadelphia, PA 19101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Watchlist Hit import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Test Company watchlist hit\",\n \"addresses\": [\n {\n \"full_address\": \"1400 Spruce Ave, Philadelphia, PA 19101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Watchlist Hit request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Test Company watchlist hit", "addresses": [ { "full_address": "1400 Spruce Ave, Philadelphia, PA 19101" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Watchlist Hit using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Test Company watchlist hit\",\n \"addresses\": [\n {\n \"full_address\": \"1400 Spruce Ave, Philadelphia, PA 19101\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Watchlist Hit import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Test Company watchlist hit", "addresses": [["full_address": "1400 Spruce Ave, Philadelphia, PA 19101"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Business Enrichment Order **Request** ```json { "name": "Dunder Mifflin Paper Company", "addresses": [ { "full_address": "1725 Slough Avenue, Scranton, PA 18501" } ], "orders": [ { "product": "business_enrichment" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Business Enrichment Order import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Dunder Mifflin Paper Company", "addresses": [{ "full_address": "1725 Slough Avenue, Scranton, PA 18501" }], "orders": [{ "product": "business_enrichment" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Business Enrichment Order const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Dunder Mifflin Paper Company","addresses":[{"full_address":"1725 Slough Avenue, Scranton, PA 18501"}],"orders":[{"product":"business_enrichment"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Business Enrichment Order package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Dunder Mifflin Paper Company\",\n \"addresses\": [\n {\n \"full_address\": \"1725 Slough Avenue, Scranton, PA 18501\"\n }\n ],\n \"orders\": [\n {\n \"product\": \"business_enrichment\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Business Enrichment Order require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Dunder Mifflin Paper Company\",\n \"addresses\": [\n {\n \"full_address\": \"1725 Slough Avenue, Scranton, PA 18501\"\n }\n ],\n \"orders\": [\n {\n \"product\": \"business_enrichment\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Business Enrichment Order import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Dunder Mifflin Paper Company\",\n \"addresses\": [\n {\n \"full_address\": \"1725 Slough Avenue, Scranton, PA 18501\"\n }\n ],\n \"orders\": [\n {\n \"product\": \"business_enrichment\"\n }\n ]\n}") .asString(); ``` ```php Business Enrichment Order request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Dunder Mifflin Paper Company", "addresses": [ { "full_address": "1725 Slough Avenue, Scranton, PA 18501" } ], "orders": [ { "product": "business_enrichment" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Business Enrichment Order using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Dunder Mifflin Paper Company\",\n \"addresses\": [\n {\n \"full_address\": \"1725 Slough Avenue, Scranton, PA 18501\"\n }\n ],\n \"orders\": [\n {\n \"product\": \"business_enrichment\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Business Enrichment Order import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Dunder Mifflin Paper Company", "addresses": [["full_address": "1725 Slough Avenue, Scranton, PA 18501"]], "orders": [["product": "business_enrichment"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status agent **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "open", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:42Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:42Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "764682dd-bf80-4426-910c-9850531fc86c", "name": "Agent", "submitted": true, "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "847dd582-2a0e-491f-8847-8821ccbbc1dd", "full_address": "369 Willow St, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "9b2e7c14-5d3a-4f8b-a1c2-6e7f8d9a0b12", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "name": "Agent", "status": "active", "jurisdiction": "HOME", "entity_type": "CORPORATION", "file_number": "123456789", "state": null, "sub_status": "GOOD_STANDING", "jurisdiction_details": { "name": "Alberta", "abbr": "AB", "authority": "Corporate Registry System (CORES)" }, "country_code": "CA", "addresses": [ "111 WELLINGTON STREET, OTTAWA, ON K1A 0A9, CANADA" ], "officers": [ { "key": "value" } ], "registration_date": "2019-04-12", "submitted": true } ], "orders": [ { "object": "order", "id": "78038d80-b8d3-45a7-9156-0ddb383e1fb7", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6e71a276-ebf4-4396-b091-3e13251a25c6", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "litigations", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "82cf21c9-6b0b-4f11-9c4f-2a925105d140", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "bankruptcies", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1276547b-1cca-416f-b451-22e4a24c25fb", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "ucc_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bca42881-ed2a-4de9-84c3-25795e280bf3", "status": "created", "business_id": "68b56939-cfc5-4e8c-af0b-51e84d413670", "product": "tax_liens", "created_at": "2025-11-05T01:57:42Z", "updated_at": "2025-11-05T01:57:42Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Agent", "name_derived": true, "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status agent import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status agent const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status agent package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status agent require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status agent import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status agent request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status agent using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status agent import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status corporation **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "2cf065e3-33ae-4c7c-8365-6a87936cd10a", "name": "Corporation", "status": "open", "created_at": "2025-11-05T01:57:37Z", "updated_at": "2025-11-05T01:57:37Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:37Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "2cf065e3-33ae-4c7c-8365-6a87936cd10a", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:37Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "4e674ee8-1a14-4f76-b0c0-e6c96be7a84e", "name": "Corporation", "submitted": true, "business_id": "2cf065e3-33ae-4c7c-8365-6a87936cd10a", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "d747bd92-b01f-4806-abed-0ccb2831e09d", "full_address": "321 Elm St, Austin, TX 78701", "submitted": true, "created_at": "2025-11-05T01:57:37Z", "updated_at": "2025-11-05T01:57:37Z", "business_id": "2cf065e3-33ae-4c7c-8365-6a87936cd10a", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "d6b5b8bd-3c07-4893-b630-67a6e0711d9e", "status": "created", "business_id": "2cf065e3-33ae-4c7c-8365-6a87936cd10a", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:37Z", "updated_at": "2025-11-05T01:57:37Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "db33a933-3770-4e96-8077-1b25f54ac70b", "status": "created", "business_id": "2cf065e3-33ae-4c7c-8365-6a87936cd10a", "product": "litigations", "created_at": "2025-11-05T01:57:37Z", "updated_at": "2025-11-05T01:57:37Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "9c3d1a15-f390-4099-a582-f3eee40b457f", "status": "created", "business_id": "2cf065e3-33ae-4c7c-8365-6a87936cd10a", "product": "bankruptcies", "created_at": "2025-11-05T01:57:37Z", "updated_at": "2025-11-05T01:57:37Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "4bf916a0-c4ca-4bf2-942e-eeca8f0e0115", "status": "created", "business_id": "2cf065e3-33ae-4c7c-8365-6a87936cd10a", "product": "ucc_liens", "created_at": "2025-11-05T01:57:37Z", "updated_at": "2025-11-05T01:57:37Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "090bbea4-5a8e-4673-babd-c96b24cfab6e", "status": "created", "business_id": "2cf065e3-33ae-4c7c-8365-6a87936cd10a", "product": "tax_liens", "created_at": "2025-11-05T01:57:37Z", "updated_at": "2025-11-05T01:57:37Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Corporation", "name_derived": true, "addresses": [ { "full_address": "321 Elm St, Austin, TX 78701" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status corporation import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status corporation const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status corporation package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status corporation require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status corporation import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status corporation request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status corporation using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status corporation import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status linkedin **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "4c659ea3-a7a0-4642-90f3-9d1a6b69ba3c", "name": "Business from LinkedIn", "status": "open", "created_at": "2025-11-05T01:57:48Z", "updated_at": "2025-11-05T01:57:48Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:48Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "4c659ea3-a7a0-4642-90f3-9d1a6b69ba3c", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:48Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "c3d716fb-5ca8-4357-8fe9-f2dcfdb5c1cd", "name": "Business from LinkedIn", "submitted": true, "business_id": "4c659ea3-a7a0-4642-90f3-9d1a6b69ba3c", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "75db4256-3c77-488b-81cf-c18751014709", "full_address": "951 Sycamore Ave, Minneapolis, MN 55401", "submitted": true, "created_at": "2025-11-05T01:57:48Z", "updated_at": "2025-11-05T01:57:48Z", "business_id": "4c659ea3-a7a0-4642-90f3-9d1a6b69ba3c", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "ae2a8680-ab1a-4ad0-a894-5188c20cd3e3", "status": "created", "business_id": "4c659ea3-a7a0-4642-90f3-9d1a6b69ba3c", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:48Z", "updated_at": "2025-11-05T01:57:48Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "8a36460b-8f22-4ae1-ac39-0e15f1c48819", "status": "created", "business_id": "4c659ea3-a7a0-4642-90f3-9d1a6b69ba3c", "product": "litigations", "created_at": "2025-11-05T01:57:48Z", "updated_at": "2025-11-05T01:57:48Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "c5f21811-6051-4ba1-b93f-4eaed9dd3220", "status": "created", "business_id": "4c659ea3-a7a0-4642-90f3-9d1a6b69ba3c", "product": "bankruptcies", "created_at": "2025-11-05T01:57:48Z", "updated_at": "2025-11-05T01:57:48Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "29cfb2b3-e014-4314-9273-c4d132d5b24b", "status": "created", "business_id": "4c659ea3-a7a0-4642-90f3-9d1a6b69ba3c", "product": "ucc_liens", "created_at": "2025-11-05T01:57:48Z", "updated_at": "2025-11-05T01:57:48Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "7582ae71-fbe7-4f8b-8ef0-87931abf79dc", "status": "created", "business_id": "4c659ea3-a7a0-4642-90f3-9d1a6b69ba3c", "product": "tax_liens", "created_at": "2025-11-05T01:57:48Z", "updated_at": "2025-11-05T01:57:48Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Business from LinkedIn", "name_derived": true, "addresses": [ { "full_address": "951 Sycamore Ave, Minneapolis, MN 55401" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status linkedin import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status linkedin const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status linkedin package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status linkedin require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status linkedin import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status linkedin request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status linkedin using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status linkedin import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status llc **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "1642842c-3f0d-4157-ad85-58e21b8a31ce", "name": "LLC", "status": "open", "created_at": "2025-11-05T01:57:43Z", "updated_at": "2025-11-05T01:57:43Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:43Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "1642842c-3f0d-4157-ad85-58e21b8a31ce", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:43Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "c817f58c-a4a2-4c1e-b2cf-bc79e3f8dceb", "name": "LLC", "submitted": true, "business_id": "1642842c-3f0d-4157-ad85-58e21b8a31ce", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "ebd52f23-5b41-46ed-8a69-7ab20f0b3d97", "full_address": "741 Aspen Way, Atlanta, GA 30301", "submitted": true, "created_at": "2025-11-05T01:57:43Z", "updated_at": "2025-11-05T01:57:43Z", "business_id": "1642842c-3f0d-4157-ad85-58e21b8a31ce", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "c82fb6dc-0a44-49cf-9eba-9e4540499b5f", "status": "created", "business_id": "1642842c-3f0d-4157-ad85-58e21b8a31ce", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:43Z", "updated_at": "2025-11-05T01:57:43Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "2dbd1391-fb0c-491e-a7be-8839949ec672", "status": "created", "business_id": "1642842c-3f0d-4157-ad85-58e21b8a31ce", "product": "litigations", "created_at": "2025-11-05T01:57:43Z", "updated_at": "2025-11-05T01:57:43Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "d08e917f-cf73-4fb7-884c-ade95b345fc7", "status": "created", "business_id": "1642842c-3f0d-4157-ad85-58e21b8a31ce", "product": "bankruptcies", "created_at": "2025-11-05T01:57:43Z", "updated_at": "2025-11-05T01:57:43Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "ec3f4723-c1b2-4058-b7df-9ddff6eeac4d", "status": "created", "business_id": "1642842c-3f0d-4157-ad85-58e21b8a31ce", "product": "ucc_liens", "created_at": "2025-11-05T01:57:43Z", "updated_at": "2025-11-05T01:57:43Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "b34d4f5f-9bb9-4280-8ab0-5285b14dec87", "status": "created", "business_id": "1642842c-3f0d-4157-ad85-58e21b8a31ce", "product": "tax_liens", "created_at": "2025-11-05T01:57:43Z", "updated_at": "2025-11-05T01:57:43Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "LLC", "name_derived": true, "addresses": [ { "full_address": "741 Aspen Way, Atlanta, GA 30301" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status llc import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status llc const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status llc package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status llc require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status llc import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status llc request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status llc using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status llc import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status long review **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "0a6b0b6c-ea40-441e-8ef3-743d9849d486", "name": "Test Company with long analyst review", "status": "open", "created_at": "2025-11-05T01:57:46Z", "updated_at": "2025-11-05T01:57:46Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:46Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "0a6b0b6c-ea40-441e-8ef3-743d9849d486", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:46Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "4c2b2f2e-030d-41ff-b97b-5c17d209fb4a", "name": "Test Company with long analyst review", "submitted": true, "business_id": "0a6b0b6c-ea40-441e-8ef3-743d9849d486", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "636b3f93-7751-4dfd-9468-0ae01eba2c8d", "full_address": "159 Redwood Pl, Las Vegas, NV 89101", "submitted": true, "created_at": "2025-11-05T01:57:46Z", "updated_at": "2025-11-05T01:57:46Z", "business_id": "0a6b0b6c-ea40-441e-8ef3-743d9849d486", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "43258cb2-6acf-47ae-aa80-b5b854a1ea33", "status": "created", "business_id": "0a6b0b6c-ea40-441e-8ef3-743d9849d486", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:46Z", "updated_at": "2025-11-05T01:57:46Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "5a0db280-6805-44bc-897a-f75b81334814", "status": "created", "business_id": "0a6b0b6c-ea40-441e-8ef3-743d9849d486", "product": "litigations", "created_at": "2025-11-05T01:57:46Z", "updated_at": "2025-11-05T01:57:46Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "461631ca-893e-4d35-ac63-3c76dd9f10cf", "status": "created", "business_id": "0a6b0b6c-ea40-441e-8ef3-743d9849d486", "product": "bankruptcies", "created_at": "2025-11-05T01:57:46Z", "updated_at": "2025-11-05T01:57:46Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "4ea6faee-9e56-4e79-99da-208daac3793e", "status": "created", "business_id": "0a6b0b6c-ea40-441e-8ef3-743d9849d486", "product": "ucc_liens", "created_at": "2025-11-05T01:57:46Z", "updated_at": "2025-11-05T01:57:46Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "97fa0daa-06b7-43f1-804d-a903e1005465", "status": "created", "business_id": "0a6b0b6c-ea40-441e-8ef3-743d9849d486", "product": "tax_liens", "created_at": "2025-11-05T01:57:46Z", "updated_at": "2025-11-05T01:57:46Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company with long analyst review", "name_derived": true, "addresses": [ { "full_address": "159 Redwood Pl, Las Vegas, NV 89101" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status long review import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status long review const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status long review package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status long review require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status long review import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status long review request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status long review using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status long review import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status non profit **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "9f19004a-384b-409c-b6d6-916a54c7e8a9", "name": "Non Profit", "status": "open", "created_at": "2025-11-05T01:57:41Z", "updated_at": "2025-11-05T01:57:41Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:41Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "9f19004a-384b-409c-b6d6-916a54c7e8a9", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:41Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "732e86a7-19c0-4760-8b4e-38b70ff27f22", "name": "Non Profit", "submitted": true, "business_id": "9f19004a-384b-409c-b6d6-916a54c7e8a9", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "1c1630c9-c872-4fd9-bb1b-425d8b9d1ad0", "full_address": "258 Spruce Ave, Miami, FL 33101", "submitted": true, "created_at": "2025-11-05T01:57:41Z", "updated_at": "2025-11-05T01:57:41Z", "business_id": "9f19004a-384b-409c-b6d6-916a54c7e8a9", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "1d7bced0-8439-486d-a1fd-eb9c01309e0b", "status": "created", "business_id": "9f19004a-384b-409c-b6d6-916a54c7e8a9", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:41Z", "updated_at": "2025-11-05T01:57:41Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1f13513f-0f54-42fe-a400-a6e7b56d8b7d", "status": "created", "business_id": "9f19004a-384b-409c-b6d6-916a54c7e8a9", "product": "litigations", "created_at": "2025-11-05T01:57:41Z", "updated_at": "2025-11-05T01:57:41Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "636a8f21-afda-4716-88fc-e89133b711d4", "status": "created", "business_id": "9f19004a-384b-409c-b6d6-916a54c7e8a9", "product": "bankruptcies", "created_at": "2025-11-05T01:57:41Z", "updated_at": "2025-11-05T01:57:41Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "192bf386-3db7-49e5-942b-e7d3107f38ec", "status": "created", "business_id": "9f19004a-384b-409c-b6d6-916a54c7e8a9", "product": "ucc_liens", "created_at": "2025-11-05T01:57:41Z", "updated_at": "2025-11-05T01:57:41Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1737c265-3c1d-4e53-8ab2-57d96c1a9ebb", "status": "created", "business_id": "9f19004a-384b-409c-b6d6-916a54c7e8a9", "product": "tax_liens", "created_at": "2025-11-05T01:57:41Z", "updated_at": "2025-11-05T01:57:41Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Non Profit", "name_derived": true, "addresses": [ { "full_address": "258 Spruce Ave, Miami, FL 33101" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status non profit import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status non profit const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status non profit package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status non profit require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status non profit import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status non profit request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status non profit using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status non profit import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status partnership **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "f0bea99e-8004-47dc-a28c-7c93073edb47", "name": "Partnership", "status": "open", "created_at": "2025-11-05T01:57:38Z", "updated_at": "2025-11-05T01:57:38Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:38Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "f0bea99e-8004-47dc-a28c-7c93073edb47", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:38Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "0b08a8be-c1ee-4d7d-8500-29a215c5f720", "name": "Partnership", "submitted": true, "business_id": "f0bea99e-8004-47dc-a28c-7c93073edb47", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "c0ff7c85-2606-45c2-b316-1c93c5428d04", "full_address": "654 Maple Dr, Denver, CO 80202", "submitted": true, "created_at": "2025-11-05T01:57:38Z", "updated_at": "2025-11-05T01:57:38Z", "business_id": "f0bea99e-8004-47dc-a28c-7c93073edb47", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "95269177-c335-4f6f-ab8e-9c629cc527de", "status": "created", "business_id": "f0bea99e-8004-47dc-a28c-7c93073edb47", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:38Z", "updated_at": "2025-11-05T01:57:38Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "b3ab3a87-84a8-41f1-9383-729a3ac41e21", "status": "created", "business_id": "f0bea99e-8004-47dc-a28c-7c93073edb47", "product": "litigations", "created_at": "2025-11-05T01:57:38Z", "updated_at": "2025-11-05T01:57:38Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "e4857532-d35c-44b1-9b0b-36ec2e61f19c", "status": "created", "business_id": "f0bea99e-8004-47dc-a28c-7c93073edb47", "product": "bankruptcies", "created_at": "2025-11-05T01:57:38Z", "updated_at": "2025-11-05T01:57:38Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1cef64d7-d59b-42b2-bed3-097985ce061f", "status": "created", "business_id": "f0bea99e-8004-47dc-a28c-7c93073edb47", "product": "ucc_liens", "created_at": "2025-11-05T01:57:38Z", "updated_at": "2025-11-05T01:57:38Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "0f99a955-e2b9-4e35-b398-dfa4df9efab6", "status": "created", "business_id": "f0bea99e-8004-47dc-a28c-7c93073edb47", "product": "tax_liens", "created_at": "2025-11-05T01:57:38Z", "updated_at": "2025-11-05T01:57:38Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Partnership", "name_derived": true, "addresses": [ { "full_address": "654 Maple Dr, Denver, CO 80202" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status partnership import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status partnership const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status partnership package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status partnership require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status partnership import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status partnership request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status partnership using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status partnership import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status short review **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "bcd0772f-6d1c-4caa-bb1a-52ef84582578", "name": "Test Company with short analyst review", "status": "open", "created_at": "2025-11-05T01:57:45Z", "updated_at": "2025-11-05T01:57:45Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:45Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "bcd0772f-6d1c-4caa-bb1a-52ef84582578", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:45Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "692eb4ac-119b-450b-8467-41e5315e5cf8", "name": "Test Company with short analyst review", "submitted": true, "business_id": "bcd0772f-6d1c-4caa-bb1a-52ef84582578", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "ba293682-f9ed-4516-9f9e-77875a709def", "full_address": "963 Cypress Ct, Nashville, TN 37201", "submitted": true, "created_at": "2025-11-05T01:57:45Z", "updated_at": "2025-11-05T01:57:45Z", "business_id": "bcd0772f-6d1c-4caa-bb1a-52ef84582578", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "a36d91fd-2e73-49b9-8c83-87ea360f6749", "status": "created", "business_id": "bcd0772f-6d1c-4caa-bb1a-52ef84582578", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:45Z", "updated_at": "2025-11-05T01:57:45Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "a989975c-e9d2-46c9-816c-7856210b5031", "status": "created", "business_id": "bcd0772f-6d1c-4caa-bb1a-52ef84582578", "product": "litigations", "created_at": "2025-11-05T01:57:45Z", "updated_at": "2025-11-05T01:57:45Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "87286823-ea95-469b-9703-a3fbd06cd69e", "status": "created", "business_id": "bcd0772f-6d1c-4caa-bb1a-52ef84582578", "product": "bankruptcies", "created_at": "2025-11-05T01:57:45Z", "updated_at": "2025-11-05T01:57:45Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "636cadb7-1de5-4581-a4b0-2b155ca41a31", "status": "created", "business_id": "bcd0772f-6d1c-4caa-bb1a-52ef84582578", "product": "ucc_liens", "created_at": "2025-11-05T01:57:45Z", "updated_at": "2025-11-05T01:57:45Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1df7c87f-d625-46cc-ba68-b7cb84d8dbbd", "status": "created", "business_id": "bcd0772f-6d1c-4caa-bb1a-52ef84582578", "product": "tax_liens", "created_at": "2025-11-05T01:57:45Z", "updated_at": "2025-11-05T01:57:45Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company with short analyst review", "name_derived": true, "addresses": [ { "full_address": "963 Cypress Ct, Nashville, TN 37201" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status short review import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status short review const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status short review package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status short review require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status short review import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status short review request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status short review using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status short review import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status sole proprietorship **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "daaacb31-7523-49cd-9b3b-63e6dd1a502c", "name": "Sole Proprietorship", "status": "open", "created_at": "2025-11-05T01:57:39Z", "updated_at": "2025-11-05T01:57:39Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:39Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "daaacb31-7523-49cd-9b3b-63e6dd1a502c", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:39Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "8bf0584e-f817-43ad-abdf-4030eff7a112", "name": "Sole Proprietorship", "submitted": true, "business_id": "daaacb31-7523-49cd-9b3b-63e6dd1a502c", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "16457aaf-6917-4c15-8fee-bae887bfe1d8", "full_address": "987 Cedar Ln, Portland, OR 97201", "submitted": true, "created_at": "2025-11-05T01:57:39Z", "updated_at": "2025-11-05T01:57:39Z", "business_id": "daaacb31-7523-49cd-9b3b-63e6dd1a502c", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "336f7a26-7885-4bae-8853-c0ab1cc9c624", "status": "created", "business_id": "daaacb31-7523-49cd-9b3b-63e6dd1a502c", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:39Z", "updated_at": "2025-11-05T01:57:39Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "c3eef9b2-03d0-49fd-a60c-379d0affe086", "status": "created", "business_id": "daaacb31-7523-49cd-9b3b-63e6dd1a502c", "product": "litigations", "created_at": "2025-11-05T01:57:39Z", "updated_at": "2025-11-05T01:57:39Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6d3de1a0-d15a-4978-9041-9d9fa8f5db5f", "status": "created", "business_id": "daaacb31-7523-49cd-9b3b-63e6dd1a502c", "product": "bankruptcies", "created_at": "2025-11-05T01:57:39Z", "updated_at": "2025-11-05T01:57:39Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "92133665-b015-4fec-b513-4672a5e2734e", "status": "created", "business_id": "daaacb31-7523-49cd-9b3b-63e6dd1a502c", "product": "ucc_liens", "created_at": "2025-11-05T01:57:39Z", "updated_at": "2025-11-05T01:57:39Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "d1e92206-2bc9-4ebd-8f6c-4c6cfbf8a7bf", "status": "created", "business_id": "daaacb31-7523-49cd-9b3b-63e6dd1a502c", "product": "tax_liens", "created_at": "2025-11-05T01:57:39Z", "updated_at": "2025-11-05T01:57:39Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Sole Proprietorship", "name_derived": true, "addresses": [ { "full_address": "987 Cedar Ln, Portland, OR 97201" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status sole proprietorship import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status sole proprietorship const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status sole proprietorship package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status sole proprietorship require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status sole proprietorship import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status sole proprietorship request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status sole proprietorship using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status sole proprietorship import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status trust **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "3c2c1fee-8031-49cd-a2f7-b95339edbfe3", "name": "Trust", "status": "open", "created_at": "2025-11-05T01:57:40Z", "updated_at": "2025-11-05T01:57:40Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:40Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "3c2c1fee-8031-49cd-a2f7-b95339edbfe3", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:40Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "49abdbea-c5da-4ff1-83b0-cd206f1d54bc", "name": "Trust", "submitted": true, "business_id": "3c2c1fee-8031-49cd-a2f7-b95339edbfe3", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "18393217-e289-40d4-91ef-ec226df0299f", "full_address": "147 Birch Rd, Boston, MA 02101", "submitted": true, "created_at": "2025-11-05T01:57:40Z", "updated_at": "2025-11-05T01:57:40Z", "business_id": "3c2c1fee-8031-49cd-a2f7-b95339edbfe3", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "f74164d3-b0d0-49ad-9d6c-fc1c45b9c981", "status": "created", "business_id": "3c2c1fee-8031-49cd-a2f7-b95339edbfe3", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:40Z", "updated_at": "2025-11-05T01:57:40Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "b2b26005-d2f5-41e4-9217-202e06c8e6ca", "status": "created", "business_id": "3c2c1fee-8031-49cd-a2f7-b95339edbfe3", "product": "litigations", "created_at": "2025-11-05T01:57:40Z", "updated_at": "2025-11-05T01:57:40Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "2a49e444-082d-4f1a-89f9-98ff5bed2a35", "status": "created", "business_id": "3c2c1fee-8031-49cd-a2f7-b95339edbfe3", "product": "bankruptcies", "created_at": "2025-11-05T01:57:40Z", "updated_at": "2025-11-05T01:57:40Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "29197fa8-93eb-4b84-8181-36b6f85a9c1a", "status": "created", "business_id": "3c2c1fee-8031-49cd-a2f7-b95339edbfe3", "product": "ucc_liens", "created_at": "2025-11-05T01:57:40Z", "updated_at": "2025-11-05T01:57:40Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "d2ad7e9e-6f01-4112-928a-9f6de6d616e4", "status": "created", "business_id": "3c2c1fee-8031-49cd-a2f7-b95339edbfe3", "product": "tax_liens", "created_at": "2025-11-05T01:57:40Z", "updated_at": "2025-11-05T01:57:40Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Trust", "name_derived": true, "addresses": [ { "full_address": "147 Birch Rd, Boston, MA 02101" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status trust import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status trust const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status trust package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status trust require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status trust import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status trust request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status trust using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status trust import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status unverified **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "638b7f6e-5499-4095-a2ac-ac47e80f20e4", "name": "Unverified Name Business", "status": "open", "created_at": "2025-11-05T01:57:36Z", "updated_at": "2025-11-05T01:57:36Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:36Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "638b7f6e-5499-4095-a2ac-ac47e80f20e4", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:36Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "99c5034f-767f-49c3-b695-f719df1f3854", "name": "Unverified Name Business", "submitted": true, "business_id": "638b7f6e-5499-4095-a2ac-ac47e80f20e4", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "08c790e7-f3bb-4a88-9676-d750f4da7779", "full_address": "789 Pine St, Seattle, WA 98101", "submitted": true, "created_at": "2025-11-05T01:57:36Z", "updated_at": "2025-11-05T01:57:36Z", "business_id": "638b7f6e-5499-4095-a2ac-ac47e80f20e4", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "dcdab618-0929-4bbc-b27c-78b9664e48c0", "status": "created", "business_id": "638b7f6e-5499-4095-a2ac-ac47e80f20e4", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:36Z", "updated_at": "2025-11-05T01:57:36Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "b1e2fd2b-ff1b-41c4-8663-e8b4b3aec58e", "status": "created", "business_id": "638b7f6e-5499-4095-a2ac-ac47e80f20e4", "product": "litigations", "created_at": "2025-11-05T01:57:36Z", "updated_at": "2025-11-05T01:57:36Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "029cfc69-cc8a-44f6-a987-d9c6eb0e2282", "status": "created", "business_id": "638b7f6e-5499-4095-a2ac-ac47e80f20e4", "product": "bankruptcies", "created_at": "2025-11-05T01:57:36Z", "updated_at": "2025-11-05T01:57:36Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "a5f121de-6256-499e-97df-bb15ed94248a", "status": "created", "business_id": "638b7f6e-5499-4095-a2ac-ac47e80f20e4", "product": "ucc_liens", "created_at": "2025-11-05T01:57:36Z", "updated_at": "2025-11-05T01:57:36Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "05091d4a-cc72-453f-a6a2-17f24345b669", "status": "created", "business_id": "638b7f6e-5499-4095-a2ac-ac47e80f20e4", "product": "tax_liens", "created_at": "2025-11-05T01:57:36Z", "updated_at": "2025-11-05T01:57:36Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Unverified Name Business", "name_derived": true, "addresses": [ { "full_address": "789 Pine St, Seattle, WA 98101" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status unverified import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status unverified const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status unverified package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status unverified require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status unverified import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status unverified request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status unverified using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status unverified import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status website **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "effa943d-3275-49e7-b213-0dc42f0cce70", "name": "Business from Website", "status": "open", "created_at": "2025-11-05T01:57:47Z", "updated_at": "2025-11-05T01:57:47Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:47Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "effa943d-3275-49e7-b213-0dc42f0cce70", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:47Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "fe476765-3b7a-40d2-9d6f-4e0005d8740f", "name": "Business from Website", "submitted": true, "business_id": "effa943d-3275-49e7-b213-0dc42f0cce70", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "2f5109a8-4f0d-48cc-86a4-5c0b35a5566a", "full_address": "753 Magnolia St, Detroit, MI 48201", "submitted": true, "created_at": "2025-11-05T01:57:47Z", "updated_at": "2025-11-05T01:57:47Z", "business_id": "effa943d-3275-49e7-b213-0dc42f0cce70", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "4165ef98-fc0b-4abf-befe-923c0d941dbb", "status": "created", "business_id": "effa943d-3275-49e7-b213-0dc42f0cce70", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:47Z", "updated_at": "2025-11-05T01:57:47Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "5ce4d339-c225-4a6c-bccb-eca5e3e013d2", "status": "created", "business_id": "effa943d-3275-49e7-b213-0dc42f0cce70", "product": "litigations", "created_at": "2025-11-05T01:57:47Z", "updated_at": "2025-11-05T01:57:47Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1be34d4f-9c63-4e4c-8d1b-31fddb801d23", "status": "created", "business_id": "effa943d-3275-49e7-b213-0dc42f0cce70", "product": "bankruptcies", "created_at": "2025-11-05T01:57:47Z", "updated_at": "2025-11-05T01:57:47Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "9afa88e3-6eea-45b3-91e2-b276120df8f4", "status": "created", "business_id": "effa943d-3275-49e7-b213-0dc42f0cce70", "product": "ucc_liens", "created_at": "2025-11-05T01:57:47Z", "updated_at": "2025-11-05T01:57:47Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "e00a63ad-dffe-4607-9f22-788303ef5856", "status": "created", "business_id": "effa943d-3275-49e7-b213-0dc42f0cce70", "product": "tax_liens", "created_at": "2025-11-05T01:57:47Z", "updated_at": "2025-11-05T01:57:47Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Business from Website", "name_derived": true, "addresses": [ { "full_address": "753 Magnolia St, Detroit, MI 48201" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status website import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status website const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status website package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status website require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status website import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status website request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status website using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status website import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Name status young **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "c8a45a43-4579-4270-b0ad-f7bec3e4a3c4", "name": "Young Business", "status": "open", "created_at": "2025-11-05T01:57:44Z", "updated_at": "2025-11-05T01:57:44Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:44Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "c8a45a43-4579-4270-b0ad-f7bec3e4a3c4", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:44Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "3c2ed6dc-af2f-4d06-a221-af817f05adee", "name": "Young Business", "submitted": true, "business_id": "c8a45a43-4579-4270-b0ad-f7bec3e4a3c4", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "764f58f9-6f43-45f4-b430-291101420f12", "full_address": "852 Palm Blvd, San Diego, CA 92101", "submitted": true, "created_at": "2025-11-05T01:57:44Z", "updated_at": "2025-11-05T01:57:44Z", "business_id": "c8a45a43-4579-4270-b0ad-f7bec3e4a3c4", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "ae20ebb4-d3d9-4d90-ac26-f3467293a530", "status": "created", "business_id": "c8a45a43-4579-4270-b0ad-f7bec3e4a3c4", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:44Z", "updated_at": "2025-11-05T01:57:44Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "a28316bb-95cb-4caa-9b6d-3ed38efdd721", "status": "created", "business_id": "c8a45a43-4579-4270-b0ad-f7bec3e4a3c4", "product": "litigations", "created_at": "2025-11-05T01:57:44Z", "updated_at": "2025-11-05T01:57:44Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "79be999e-cbf0-4ccb-b6a0-b51928643857", "status": "created", "business_id": "c8a45a43-4579-4270-b0ad-f7bec3e4a3c4", "product": "bankruptcies", "created_at": "2025-11-05T01:57:44Z", "updated_at": "2025-11-05T01:57:44Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "b48dc652-6ad5-47af-8ab9-ed2e5e983605", "status": "created", "business_id": "c8a45a43-4579-4270-b0ad-f7bec3e4a3c4", "product": "ucc_liens", "created_at": "2025-11-05T01:57:44Z", "updated_at": "2025-11-05T01:57:44Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "d7349d2a-5d8d-4947-a7fe-fbc3b0fbd73f", "status": "created", "business_id": "c8a45a43-4579-4270-b0ad-f7bec3e4a3c4", "product": "tax_liens", "created_at": "2025-11-05T01:57:44Z", "updated_at": "2025-11-05T01:57:44Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Young Business", "name_derived": true, "addresses": [ { "full_address": "852 Palm Blvd, San Diego, CA 92101" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Name status young import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Name status young const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Name status young package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Name status young require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Name status young import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Name status young request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Name status young using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Name status young import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Sos status inactive **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "dd717326-5a8c-4a1a-9930-aaf5e348edb9", "name": "Domestic Inactive", "status": "open", "created_at": "2025-11-05T01:57:50Z", "updated_at": "2025-11-05T01:57:50Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:50Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "dd717326-5a8c-4a1a-9930-aaf5e348edb9", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:50Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "4c063705-820c-4d84-a554-0e8a5bfe5f1a", "name": "Domestic Inactive", "submitted": true, "business_id": "dd717326-5a8c-4a1a-9930-aaf5e348edb9", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "a01c8d2d-7301-40ff-a633-4d9a5f9402bf", "full_address": "200 Broadway, New York, NY 10007", "submitted": true, "created_at": "2025-11-05T01:57:50Z", "updated_at": "2025-11-05T01:57:50Z", "business_id": "dd717326-5a8c-4a1a-9930-aaf5e348edb9", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "f98a6e36-c822-44ac-ab5e-6722b26448a6", "status": "created", "business_id": "dd717326-5a8c-4a1a-9930-aaf5e348edb9", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:50Z", "updated_at": "2025-11-05T01:57:50Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "78a7c26a-b918-4bf7-9dff-82591e39ca2b", "status": "created", "business_id": "dd717326-5a8c-4a1a-9930-aaf5e348edb9", "product": "litigations", "created_at": "2025-11-05T01:57:50Z", "updated_at": "2025-11-05T01:57:50Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "f9dbfc48-91a9-44e1-b39d-5bf3cadba8ea", "status": "created", "business_id": "dd717326-5a8c-4a1a-9930-aaf5e348edb9", "product": "bankruptcies", "created_at": "2025-11-05T01:57:50Z", "updated_at": "2025-11-05T01:57:50Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6d457c37-ef3c-48e6-adeb-eee6ca85bfc8", "status": "created", "business_id": "dd717326-5a8c-4a1a-9930-aaf5e348edb9", "product": "ucc_liens", "created_at": "2025-11-05T01:57:50Z", "updated_at": "2025-11-05T01:57:50Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "cd76323f-4599-4b2e-ba0c-7c3103cc3811", "status": "created", "business_id": "dd717326-5a8c-4a1a-9930-aaf5e348edb9", "product": "tax_liens", "created_at": "2025-11-05T01:57:50Z", "updated_at": "2025-11-05T01:57:50Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Domestic Inactive", "name_derived": true, "addresses": [ { "full_address": "200 Broadway, New York, NY 10007" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Sos status inactive import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Sos status inactive const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Sos status inactive package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Sos status inactive require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Sos status inactive import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Sos status inactive request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Sos status inactive using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Sos status inactive import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Sos status missing **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "c823b704-1897-4f8e-92d6-15bf9809dd4c", "name": "Domestic Missing", "status": "open", "created_at": "2025-11-05T01:57:49Z", "updated_at": "2025-11-05T01:57:49Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:49Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "c823b704-1897-4f8e-92d6-15bf9809dd4c", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:49Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "0a31488c-e64b-4df0-94b1-1879117ca20c", "name": "Domestic Missing", "submitted": true, "business_id": "c823b704-1897-4f8e-92d6-15bf9809dd4c", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "49b0b585-9ece-49b8-8364-1bf72a0b5fba", "full_address": "100 Market St, San Francisco, CA 94105", "submitted": true, "created_at": "2025-11-05T01:57:49Z", "updated_at": "2025-11-05T01:57:49Z", "business_id": "c823b704-1897-4f8e-92d6-15bf9809dd4c", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "3f05948b-7d68-42dd-bba6-8efa3eaf2fbe", "status": "created", "business_id": "c823b704-1897-4f8e-92d6-15bf9809dd4c", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:49Z", "updated_at": "2025-11-05T01:57:49Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "06848bad-d91b-4587-a389-79260b39ca00", "status": "created", "business_id": "c823b704-1897-4f8e-92d6-15bf9809dd4c", "product": "litigations", "created_at": "2025-11-05T01:57:49Z", "updated_at": "2025-11-05T01:57:49Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "355d77a9-5b66-456a-9956-456b080bffaa", "status": "created", "business_id": "c823b704-1897-4f8e-92d6-15bf9809dd4c", "product": "bankruptcies", "created_at": "2025-11-05T01:57:49Z", "updated_at": "2025-11-05T01:57:49Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1741e5a0-4544-4258-b4aa-43879ac21c86", "status": "created", "business_id": "c823b704-1897-4f8e-92d6-15bf9809dd4c", "product": "ucc_liens", "created_at": "2025-11-05T01:57:49Z", "updated_at": "2025-11-05T01:57:49Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "3b0848b4-5f79-4bbf-a1b2-a9b359157e11", "status": "created", "business_id": "c823b704-1897-4f8e-92d6-15bf9809dd4c", "product": "tax_liens", "created_at": "2025-11-05T01:57:49Z", "updated_at": "2025-11-05T01:57:49Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Domestic Missing", "name_derived": true, "addresses": [ { "full_address": "100 Market St, San Francisco, CA 94105" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Sos status missing import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Sos status missing const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Sos status missing package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Sos status missing require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Sos status missing import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Sos status missing request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Sos status missing using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Sos status missing import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Sos status partial inactive **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "4170f52f-7450-4d39-b9ce-4ee346629ec7", "name": "Partial Inactive", "status": "open", "created_at": "2025-11-05T01:57:52Z", "updated_at": "2025-11-05T01:57:52Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:52Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "4170f52f-7450-4d39-b9ce-4ee346629ec7", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:52Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "98044b8e-24ca-4375-b0cb-addc014f532f", "name": "Partial Inactive", "submitted": true, "business_id": "4170f52f-7450-4d39-b9ce-4ee346629ec7", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "1d89f271-8705-4839-8b2f-5a2cede67826", "full_address": "400 Pike St, Seattle, WA 98101", "submitted": true, "created_at": "2025-11-05T01:57:52Z", "updated_at": "2025-11-05T01:57:52Z", "business_id": "4170f52f-7450-4d39-b9ce-4ee346629ec7", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "b1a113e0-13dc-401c-a7ac-d85d20a87449", "status": "created", "business_id": "4170f52f-7450-4d39-b9ce-4ee346629ec7", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:52Z", "updated_at": "2025-11-05T01:57:52Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "c144ccdb-d37a-4dbc-911b-84db3944356e", "status": "created", "business_id": "4170f52f-7450-4d39-b9ce-4ee346629ec7", "product": "litigations", "created_at": "2025-11-05T01:57:52Z", "updated_at": "2025-11-05T01:57:52Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "ee0b85d9-2c5e-45d7-912c-ac2680ffa056", "status": "created", "business_id": "4170f52f-7450-4d39-b9ce-4ee346629ec7", "product": "bankruptcies", "created_at": "2025-11-05T01:57:52Z", "updated_at": "2025-11-05T01:57:52Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "77202fb8-f0bc-43e1-9370-712cc492c62f", "status": "created", "business_id": "4170f52f-7450-4d39-b9ce-4ee346629ec7", "product": "ucc_liens", "created_at": "2025-11-05T01:57:52Z", "updated_at": "2025-11-05T01:57:52Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "a95fd821-12a9-46db-afd1-64ed46571224", "status": "created", "business_id": "4170f52f-7450-4d39-b9ce-4ee346629ec7", "product": "tax_liens", "created_at": "2025-11-05T01:57:52Z", "updated_at": "2025-11-05T01:57:52Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Partial Inactive", "name_derived": true, "addresses": [ { "full_address": "400 Pike St, Seattle, WA 98101" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Sos status partial inactive import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Sos status partial inactive const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Sos status partial inactive package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Sos status partial inactive require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Sos status partial inactive import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Sos status partial inactive request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Sos status partial inactive using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Sos status partial inactive import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Sos status unknown **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "0ec38cac-2e8e-466c-99b4-eebacd3d2c8a", "name": "Domestic Unknown", "status": "open", "created_at": "2025-11-05T01:57:51Z", "updated_at": "2025-11-05T01:57:51Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:51Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "0ec38cac-2e8e-466c-99b4-eebacd3d2c8a", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:51Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "5b7c1437-4a78-40ad-b492-b5500e58c0ca", "name": "Domestic Unknown", "submitted": true, "business_id": "0ec38cac-2e8e-466c-99b4-eebacd3d2c8a", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "63c0001f-3e42-46ca-ac10-a2e33c7ee47e", "full_address": "300 Congress Ave, Austin, TX 78701", "submitted": true, "created_at": "2025-11-05T01:57:51Z", "updated_at": "2025-11-05T01:57:51Z", "business_id": "0ec38cac-2e8e-466c-99b4-eebacd3d2c8a", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "a7266cce-3238-4803-b87b-837987930539", "status": "created", "business_id": "0ec38cac-2e8e-466c-99b4-eebacd3d2c8a", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:51Z", "updated_at": "2025-11-05T01:57:51Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "888bfcc1-3725-451c-82fc-4f4f413e3bae", "status": "created", "business_id": "0ec38cac-2e8e-466c-99b4-eebacd3d2c8a", "product": "litigations", "created_at": "2025-11-05T01:57:51Z", "updated_at": "2025-11-05T01:57:51Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "da221136-2fe2-48f5-91cf-a4c10ff92f3d", "status": "created", "business_id": "0ec38cac-2e8e-466c-99b4-eebacd3d2c8a", "product": "bankruptcies", "created_at": "2025-11-05T01:57:51Z", "updated_at": "2025-11-05T01:57:51Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "8b371fde-4734-47e9-9656-62de8e3ccb7c", "status": "created", "business_id": "0ec38cac-2e8e-466c-99b4-eebacd3d2c8a", "product": "ucc_liens", "created_at": "2025-11-05T01:57:51Z", "updated_at": "2025-11-05T01:57:51Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "43d815ab-a077-44df-a04f-7632c83a2169", "status": "created", "business_id": "0ec38cac-2e8e-466c-99b4-eebacd3d2c8a", "product": "tax_liens", "created_at": "2025-11-05T01:57:51Z", "updated_at": "2025-11-05T01:57:51Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Domestic Unknown", "name_derived": true, "addresses": [ { "full_address": "300 Congress Ave, Austin, TX 78701" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Sos status unknown import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Sos status unknown const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Sos status unknown package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Sos status unknown require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Sos status unknown import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Sos status unknown request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Sos status unknown using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Sos status unknown import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address status approximate **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "a56fde57-0de5-4fff-a35e-d1f82534d76a", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:57:55Z", "updated_at": "2025-11-05T01:57:55Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:55Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "a56fde57-0de5-4fff-a35e-d1f82534d76a", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:55Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "a7e76adc-1e98-4fa4-bf16-ab9144c0c24d", "name": "Test Company", "submitted": true, "business_id": "a56fde57-0de5-4fff-a35e-d1f82534d76a", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "494c2f5b-3cc5-4027-af6c-f6fa9bc38b07", "full_address": "423 Grand St., New York, NY 10013", "submitted": true, "created_at": "2025-11-05T01:57:55Z", "updated_at": "2025-11-05T01:57:55Z", "business_id": "a56fde57-0de5-4fff-a35e-d1f82534d76a", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "ea7875a5-3eaa-46e6-a76d-3bed84ce79dc", "status": "created", "business_id": "a56fde57-0de5-4fff-a35e-d1f82534d76a", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:55Z", "updated_at": "2025-11-05T01:57:55Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "86e37dc7-4e2c-4eff-9923-7647ca522952", "status": "created", "business_id": "a56fde57-0de5-4fff-a35e-d1f82534d76a", "product": "litigations", "created_at": "2025-11-05T01:57:55Z", "updated_at": "2025-11-05T01:57:55Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "1b7f7f6d-45b9-422e-935c-2347513b0940", "status": "created", "business_id": "a56fde57-0de5-4fff-a35e-d1f82534d76a", "product": "bankruptcies", "created_at": "2025-11-05T01:57:55Z", "updated_at": "2025-11-05T01:57:55Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "74860757-91a7-4075-aa55-f8e019c943ab", "status": "created", "business_id": "a56fde57-0de5-4fff-a35e-d1f82534d76a", "product": "ucc_liens", "created_at": "2025-11-05T01:57:55Z", "updated_at": "2025-11-05T01:57:55Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "5a057990-1a58-494f-b07b-ef481c35b3bc", "status": "created", "business_id": "a56fde57-0de5-4fff-a35e-d1f82534d76a", "product": "tax_liens", "created_at": "2025-11-05T01:57:55Z", "updated_at": "2025-11-05T01:57:55Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "423 Grand St., New York, NY 10013" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address status approximate import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address status approximate const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address status approximate package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address status approximate require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address status approximate import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address status approximate request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address status approximate using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address status approximate import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address status cmra **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "04334be3-185e-4f48-80e0-58bb35078b82", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:57:57Z", "updated_at": "2025-11-05T01:57:57Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:58Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "04334be3-185e-4f48-80e0-58bb35078b82", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:57Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "f9a68dbe-356a-414f-8ce5-1997189dcb80", "name": "Test Company", "submitted": true, "business_id": "04334be3-185e-4f48-80e0-58bb35078b82", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "e0ca4068-a19c-411d-97f9-7851556519c1", "full_address": "991 cmra st., New York, NY 10013", "submitted": true, "created_at": "2025-11-05T01:57:58Z", "updated_at": "2025-11-05T01:57:58Z", "business_id": "04334be3-185e-4f48-80e0-58bb35078b82", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "83696559-3c5e-4aec-b928-d6e102993fb4", "status": "created", "business_id": "04334be3-185e-4f48-80e0-58bb35078b82", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:58Z", "updated_at": "2025-11-05T01:57:58Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6bde4d6d-c3d5-41d5-949d-ecdc95e8f9af", "status": "created", "business_id": "04334be3-185e-4f48-80e0-58bb35078b82", "product": "litigations", "created_at": "2025-11-05T01:57:58Z", "updated_at": "2025-11-05T01:57:58Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "a4f01fbe-7864-4af9-8724-3ddcce0b3052", "status": "created", "business_id": "04334be3-185e-4f48-80e0-58bb35078b82", "product": "bankruptcies", "created_at": "2025-11-05T01:57:58Z", "updated_at": "2025-11-05T01:57:58Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "a7ace1f5-2267-41cb-99f8-6fa3a0bfafed", "status": "created", "business_id": "04334be3-185e-4f48-80e0-58bb35078b82", "product": "ucc_liens", "created_at": "2025-11-05T01:57:58Z", "updated_at": "2025-11-05T01:57:58Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "0add8290-8072-43f1-832d-698665a4b1a4", "status": "created", "business_id": "04334be3-185e-4f48-80e0-58bb35078b82", "product": "tax_liens", "created_at": "2025-11-05T01:57:58Z", "updated_at": "2025-11-05T01:57:58Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "991 cmra st., New York, NY 10013" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address status cmra import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address status cmra const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address status cmra package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address status cmra require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address status cmra import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address status cmra request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address status cmra using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address status cmra import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address status incomplete **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "92e2815e-bc67-4a71-b0dd-072a744a7a37", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:57:56Z", "updated_at": "2025-11-05T01:57:56Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:56Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "92e2815e-bc67-4a71-b0dd-072a744a7a37", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:56Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "02ff3cf4-dbda-4e09-9c81-f1f44301a853", "name": "Test Company", "submitted": true, "business_id": "92e2815e-bc67-4a71-b0dd-072a744a7a37", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "7aafd769-96e1-40b5-879d-c8f8dad0c15c", "full_address": "New York, NY", "submitted": true, "created_at": "2025-11-05T01:57:56Z", "updated_at": "2025-11-05T01:57:56Z", "business_id": "92e2815e-bc67-4a71-b0dd-072a744a7a37", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "c6addf47-4643-46e3-9b24-0c614793d8f7", "status": "created", "business_id": "92e2815e-bc67-4a71-b0dd-072a744a7a37", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:56Z", "updated_at": "2025-11-05T01:57:56Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "20ba788c-9a52-4b15-9697-38869ead999c", "status": "created", "business_id": "92e2815e-bc67-4a71-b0dd-072a744a7a37", "product": "litigations", "created_at": "2025-11-05T01:57:56Z", "updated_at": "2025-11-05T01:57:56Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "bb8f8c9e-d8a9-4bfa-9ec3-363005ea3f8d", "status": "created", "business_id": "92e2815e-bc67-4a71-b0dd-072a744a7a37", "product": "bankruptcies", "created_at": "2025-11-05T01:57:56Z", "updated_at": "2025-11-05T01:57:56Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "c76d6dac-b4e0-4bcc-b14e-22c1dc06dc84", "status": "created", "business_id": "92e2815e-bc67-4a71-b0dd-072a744a7a37", "product": "ucc_liens", "created_at": "2025-11-05T01:57:56Z", "updated_at": "2025-11-05T01:57:56Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "b9d953c2-d067-4a0f-b2a8-7cd98f50036e", "status": "created", "business_id": "92e2815e-bc67-4a71-b0dd-072a744a7a37", "product": "tax_liens", "created_at": "2025-11-05T01:57:56Z", "updated_at": "2025-11-05T01:57:56Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "New York, NY" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address status incomplete import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address status incomplete const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address status incomplete package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address status incomplete require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address status incomplete import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address status incomplete request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address status incomplete using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address status incomplete import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address status no match **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "3b4384c4-0fb8-4683-9e29-6593970164b7", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:57:53Z", "updated_at": "2025-11-05T01:57:53Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:53Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "3b4384c4-0fb8-4683-9e29-6593970164b7", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:53Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "2bbd369e-c58a-4bce-a2e4-93c73c4fd418", "name": "Test Company", "submitted": true, "business_id": "3b4384c4-0fb8-4683-9e29-6593970164b7", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "86b911fa-6d4c-4512-9356-c602ef8494e1", "full_address": "123 Grand St., New York, NY 10013", "submitted": true, "created_at": "2025-11-05T01:57:53Z", "updated_at": "2025-11-05T01:57:53Z", "business_id": "3b4384c4-0fb8-4683-9e29-6593970164b7", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "9639720d-a9cc-4cc7-bbd2-97a8242820fd", "status": "created", "business_id": "3b4384c4-0fb8-4683-9e29-6593970164b7", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:53Z", "updated_at": "2025-11-05T01:57:53Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "fc1ef835-d931-4a74-a68a-ead18c8d7fe2", "status": "created", "business_id": "3b4384c4-0fb8-4683-9e29-6593970164b7", "product": "litigations", "created_at": "2025-11-05T01:57:53Z", "updated_at": "2025-11-05T01:57:53Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "16e5dacc-0ca4-4ff0-9f77-dd5dc21efdd0", "status": "created", "business_id": "3b4384c4-0fb8-4683-9e29-6593970164b7", "product": "bankruptcies", "created_at": "2025-11-05T01:57:53Z", "updated_at": "2025-11-05T01:57:53Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "8e68d02a-bc9e-4032-bd8f-e32c8400b1fd", "status": "created", "business_id": "3b4384c4-0fb8-4683-9e29-6593970164b7", "product": "ucc_liens", "created_at": "2025-11-05T01:57:53Z", "updated_at": "2025-11-05T01:57:53Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "e447d0d6-7f90-4fe1-a9e8-1dd6eeb7a676", "status": "created", "business_id": "3b4384c4-0fb8-4683-9e29-6593970164b7", "product": "tax_liens", "created_at": "2025-11-05T01:57:53Z", "updated_at": "2025-11-05T01:57:53Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "123 Grand St., New York, NY 10013" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address status no match import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address status no match const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address status no match package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address status no match require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address status no match import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address status no match request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address status no match using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address status no match import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address status registered agent **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "3ecba3be-c49d-44ec-a547-fcb6d9a29d29", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:57:59Z", "updated_at": "2025-11-05T01:57:59Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:59Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "3ecba3be-c49d-44ec-a547-fcb6d9a29d29", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:59Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "d711f02e-6c34-42da-aaff-80516ebdf02e", "name": "Test Company", "submitted": true, "business_id": "3ecba3be-c49d-44ec-a547-fcb6d9a29d29", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "5b25fb38-12ac-48bf-afc4-f7f9803755d4", "full_address": "991 registered agent st., New York, NY 10013", "submitted": true, "created_at": "2025-11-05T01:57:59Z", "updated_at": "2025-11-05T01:57:59Z", "business_id": "3ecba3be-c49d-44ec-a547-fcb6d9a29d29", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "f1ca89bc-c41c-459c-b208-ad8eaf2f7517", "status": "created", "business_id": "3ecba3be-c49d-44ec-a547-fcb6d9a29d29", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:59Z", "updated_at": "2025-11-05T01:57:59Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "0d499194-b13d-4dc7-9d44-e769df8c2f92", "status": "created", "business_id": "3ecba3be-c49d-44ec-a547-fcb6d9a29d29", "product": "litigations", "created_at": "2025-11-05T01:57:59Z", "updated_at": "2025-11-05T01:57:59Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "94d42975-a185-48cf-b44c-27ab61223ab3", "status": "created", "business_id": "3ecba3be-c49d-44ec-a547-fcb6d9a29d29", "product": "bankruptcies", "created_at": "2025-11-05T01:57:59Z", "updated_at": "2025-11-05T01:57:59Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6b9d4bdb-2788-49c2-b0b6-fe551cc9eb2c", "status": "created", "business_id": "3ecba3be-c49d-44ec-a547-fcb6d9a29d29", "product": "ucc_liens", "created_at": "2025-11-05T01:57:59Z", "updated_at": "2025-11-05T01:57:59Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "0dc43572-b344-4060-9a7a-4ab6a7bef73d", "status": "created", "business_id": "3ecba3be-c49d-44ec-a547-fcb6d9a29d29", "product": "tax_liens", "created_at": "2025-11-05T01:57:59Z", "updated_at": "2025-11-05T01:57:59Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "991 registered agent st., New York, NY 10013" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address status registered agent import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address status registered agent const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address status registered agent package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address status registered agent require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address status registered agent import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address status registered agent request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address status registered agent using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address status registered agent import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address status similar **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "25324503-f69a-4576-8d01-0ec65fb31ffc", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:57:54Z", "updated_at": "2025-11-05T01:57:54Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:57:54Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "25324503-f69a-4576-8d01-0ec65fb31ffc", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:57:54Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "b8072172-2ff9-45dc-9917-a59f6a3d3783", "name": "Test Company", "submitted": true, "business_id": "25324503-f69a-4576-8d01-0ec65fb31ffc", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "3430c8bd-ac94-4bcd-b242-f5b5850b5d1f", "full_address": "223 Grand St., New York, NY 10013", "submitted": true, "created_at": "2025-11-05T01:57:54Z", "updated_at": "2025-11-05T01:57:54Z", "business_id": "25324503-f69a-4576-8d01-0ec65fb31ffc", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "e28b9427-4bcb-48e9-b61c-9519713384c7", "status": "created", "business_id": "25324503-f69a-4576-8d01-0ec65fb31ffc", "product": "business_verification_verify", "created_at": "2025-11-05T01:57:54Z", "updated_at": "2025-11-05T01:57:54Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "577b295e-c09b-413f-be92-732523b0b3b1", "status": "created", "business_id": "25324503-f69a-4576-8d01-0ec65fb31ffc", "product": "litigations", "created_at": "2025-11-05T01:57:54Z", "updated_at": "2025-11-05T01:57:54Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "439290a8-b792-46e7-abd3-d5c2f4e54cbb", "status": "created", "business_id": "25324503-f69a-4576-8d01-0ec65fb31ffc", "product": "bankruptcies", "created_at": "2025-11-05T01:57:54Z", "updated_at": "2025-11-05T01:57:54Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "9683dfe0-30d3-45f3-ba0c-2db59c87efee", "status": "created", "business_id": "25324503-f69a-4576-8d01-0ec65fb31ffc", "product": "ucc_liens", "created_at": "2025-11-05T01:57:54Z", "updated_at": "2025-11-05T01:57:54Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "0bbfe61b-8a57-481e-8718-11f15ef2f92f", "status": "created", "business_id": "25324503-f69a-4576-8d01-0ec65fb31ffc", "product": "tax_liens", "created_at": "2025-11-05T01:57:54Z", "updated_at": "2025-11-05T01:57:54Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "223 Grand St., New York, NY 10013" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address status similar import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address status similar const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address status similar package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address status similar require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address status similar import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address status similar request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address status similar using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address status similar import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Address status undeliverable **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "dc011295-fbbe-49f0-8ff2-2bda763b2370", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:58:00Z", "updated_at": "2025-11-05T01:58:00Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:00Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "dc011295-fbbe-49f0-8ff2-2bda763b2370", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:00Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "99c9fbca-c80e-4cfd-ba18-6ebfadf45e7b", "name": "Test Company", "submitted": true, "business_id": "dc011295-fbbe-49f0-8ff2-2bda763b2370", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "39259afd-503f-4d16-b035-b212b480de5c", "full_address": "991 st. undeliverable, New York, NY 10013", "submitted": true, "created_at": "2025-11-05T01:58:00Z", "updated_at": "2025-11-05T01:58:00Z", "business_id": "dc011295-fbbe-49f0-8ff2-2bda763b2370", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "a0af1b7e-8e94-47ce-981a-90e3cd57f742", "status": "created", "business_id": "dc011295-fbbe-49f0-8ff2-2bda763b2370", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:00Z", "updated_at": "2025-11-05T01:58:00Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "be985c87-c472-48fd-a1e1-aa7bbf9bccdd", "status": "created", "business_id": "dc011295-fbbe-49f0-8ff2-2bda763b2370", "product": "litigations", "created_at": "2025-11-05T01:58:00Z", "updated_at": "2025-11-05T01:58:00Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6f4d1afc-16b4-40d9-893f-8112fd6e7406", "status": "created", "business_id": "dc011295-fbbe-49f0-8ff2-2bda763b2370", "product": "bankruptcies", "created_at": "2025-11-05T01:58:00Z", "updated_at": "2025-11-05T01:58:00Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "85aee8da-1884-4cbb-a17c-387a55edd1f0", "status": "created", "business_id": "dc011295-fbbe-49f0-8ff2-2bda763b2370", "product": "ucc_liens", "created_at": "2025-11-05T01:58:00Z", "updated_at": "2025-11-05T01:58:00Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "d01e7eca-57d9-4bb8-946f-4c7a6fc6e4c2", "status": "created", "business_id": "dc011295-fbbe-49f0-8ff2-2bda763b2370", "product": "tax_liens", "created_at": "2025-11-05T01:58:00Z", "updated_at": "2025-11-05T01:58:00Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "991 st. undeliverable, New York, NY 10013" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Address status undeliverable import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Address status undeliverable const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Address status undeliverable package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Address status undeliverable require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Address status undeliverable import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Address status undeliverable request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Address status undeliverable using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Address status undeliverable import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Entity type corporation mismatch **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "76637d62-b031-4e1b-bba5-ccab0aae0f91", "name": "Test Corporation Inc", "status": "open", "created_at": "2025-11-05T01:58:01Z", "updated_at": "2025-11-05T01:58:01Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:01Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "76637d62-b031-4e1b-bba5-ccab0aae0f91", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:01Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "8c41e27e-310a-4d32-bb16-f4be28d7a9a4", "name": "Test Corporation Inc", "submitted": true, "business_id": "76637d62-b031-4e1b-bba5-ccab0aae0f91", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "36d0b401-8443-4cdb-be47-f726abc8278b", "full_address": "500 Main St, Chicago, IL 60601", "submitted": true, "created_at": "2025-11-05T01:58:01Z", "updated_at": "2025-11-05T01:58:01Z", "business_id": "76637d62-b031-4e1b-bba5-ccab0aae0f91", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "8593d96f-fc74-4384-9399-37907f3d4916", "status": "created", "business_id": "76637d62-b031-4e1b-bba5-ccab0aae0f91", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:01Z", "updated_at": "2025-11-05T01:58:01Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "8d4f5f57-4aca-41ab-8e29-81c0938a45b7", "status": "created", "business_id": "76637d62-b031-4e1b-bba5-ccab0aae0f91", "product": "litigations", "created_at": "2025-11-05T01:58:01Z", "updated_at": "2025-11-05T01:58:01Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "afc3835e-cb58-442d-a9f6-839a2187514d", "status": "created", "business_id": "76637d62-b031-4e1b-bba5-ccab0aae0f91", "product": "bankruptcies", "created_at": "2025-11-05T01:58:01Z", "updated_at": "2025-11-05T01:58:01Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6f13bdfe-491f-4f43-830b-994191894fb6", "status": "created", "business_id": "76637d62-b031-4e1b-bba5-ccab0aae0f91", "product": "ucc_liens", "created_at": "2025-11-05T01:58:01Z", "updated_at": "2025-11-05T01:58:01Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "e49b74c5-7f4f-4a8c-8387-3f3db6033ba0", "status": "created", "business_id": "76637d62-b031-4e1b-bba5-ccab0aae0f91", "product": "tax_liens", "created_at": "2025-11-05T01:58:01Z", "updated_at": "2025-11-05T01:58:01Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Corporation Inc", "name_derived": true, "addresses": [ { "full_address": "500 Main St, Chicago, IL 60601" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Entity type corporation mismatch import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Entity type corporation mismatch const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Entity type corporation mismatch package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Entity type corporation mismatch require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Entity type corporation mismatch import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Entity type corporation mismatch request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Entity type corporation mismatch using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Entity type corporation mismatch import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Entity type llc match **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "9a57beb8-6788-4029-896c-3037fd4a617c", "name": "Test LLC", "status": "open", "created_at": "2025-11-05T01:58:02Z", "updated_at": "2025-11-05T01:58:02Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:02Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "9a57beb8-6788-4029-896c-3037fd4a617c", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:02Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "09bcaf7d-bf26-454d-8030-a40f5b674396", "name": "Test LLC", "submitted": true, "business_id": "9a57beb8-6788-4029-896c-3037fd4a617c", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "801a21d3-6b32-4b20-aabe-ea58790ec89d", "full_address": "600 State St, Boston, MA 02109", "submitted": true, "created_at": "2025-11-05T01:58:02Z", "updated_at": "2025-11-05T01:58:02Z", "business_id": "9a57beb8-6788-4029-896c-3037fd4a617c", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "69ba7f60-b2fb-4db6-91f4-85a4a7cc4539", "status": "created", "business_id": "9a57beb8-6788-4029-896c-3037fd4a617c", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:02Z", "updated_at": "2025-11-05T01:58:02Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "28fc3384-b733-4734-98f3-11694e7e61b9", "status": "created", "business_id": "9a57beb8-6788-4029-896c-3037fd4a617c", "product": "litigations", "created_at": "2025-11-05T01:58:02Z", "updated_at": "2025-11-05T01:58:02Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "13197b54-a485-449c-a551-d6dca0f1a3ac", "status": "created", "business_id": "9a57beb8-6788-4029-896c-3037fd4a617c", "product": "bankruptcies", "created_at": "2025-11-05T01:58:02Z", "updated_at": "2025-11-05T01:58:02Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "aed52489-7822-40d2-9c78-ac7a348a25e1", "status": "created", "business_id": "9a57beb8-6788-4029-896c-3037fd4a617c", "product": "ucc_liens", "created_at": "2025-11-05T01:58:02Z", "updated_at": "2025-11-05T01:58:02Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "e9f6b130-677f-41d7-90ca-39e04c5cad9b", "status": "created", "business_id": "9a57beb8-6788-4029-896c-3037fd4a617c", "product": "tax_liens", "created_at": "2025-11-05T01:58:02Z", "updated_at": "2025-11-05T01:58:02Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test LLC", "name_derived": true, "addresses": [ { "full_address": "600 State St, Boston, MA 02109" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Entity type llc match import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Entity type llc match const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Entity type llc match package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Entity type llc match require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Entity type llc match import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Entity type llc match request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Entity type llc match using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Entity type llc match import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Tin status irs unavailable **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "17edd5d8-cf22-4ef6-af54-dfdc455d601f", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:58:09Z", "updated_at": "2025-11-05T01:58:09Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:09Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "17edd5d8-cf22-4ef6-af54-dfdc455d601f", "tin": "33-3444555", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:09Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "459d6cbe-3b41-4929-8a12-a5b174b0a5ed", "name": "Test Company", "submitted": true, "business_id": "17edd5d8-cf22-4ef6-af54-dfdc455d601f", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "2e47aa75-b507-4fe8-ad91-2b2761f84871", "full_address": "1300 Birch Rd, Houston, TX 77001", "submitted": true, "created_at": "2025-11-05T01:58:09Z", "updated_at": "2025-11-05T01:58:09Z", "business_id": "17edd5d8-cf22-4ef6-af54-dfdc455d601f", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "cb8f8c1e-2ab4-4594-8271-6fabf7bfaf2f", "status": "created", "business_id": "17edd5d8-cf22-4ef6-af54-dfdc455d601f", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:09Z", "updated_at": "2025-11-05T01:58:09Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "ce46d029-2aa8-4a7f-a5d9-bb8df7ba6cb1", "status": "created", "business_id": "17edd5d8-cf22-4ef6-af54-dfdc455d601f", "product": "litigations", "created_at": "2025-11-05T01:58:09Z", "updated_at": "2025-11-05T01:58:09Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "7840a80f-17d3-4975-98e3-b3eae91f38a0", "status": "created", "business_id": "17edd5d8-cf22-4ef6-af54-dfdc455d601f", "product": "bankruptcies", "created_at": "2025-11-05T01:58:09Z", "updated_at": "2025-11-05T01:58:09Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6815f2fc-5308-498b-a37a-23585a269370", "status": "created", "business_id": "17edd5d8-cf22-4ef6-af54-dfdc455d601f", "product": "ucc_liens", "created_at": "2025-11-05T01:58:09Z", "updated_at": "2025-11-05T01:58:09Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "c700e9ca-78e9-4a9b-b0cf-8481d42a7541", "status": "created", "business_id": "17edd5d8-cf22-4ef6-af54-dfdc455d601f", "product": "tax_liens", "created_at": "2025-11-05T01:58:09Z", "updated_at": "2025-11-05T01:58:09Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "1300 Birch Rd, Houston, TX 77001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "333444555" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Tin status irs unavailable import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Tin status irs unavailable const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Tin status irs unavailable package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Tin status irs unavailable require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Tin status irs unavailable import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Tin status irs unavailable request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Tin status irs unavailable using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Tin status irs unavailable import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Tin status matches person **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:58:06Z", "updated_at": "2025-11-05T01:58:06Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:06Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "tin": "22-2333444", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:06Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "7a074085-70d6-4a55-bef6-1ca7de1da1b4", "name": "Test Company", "submitted": true, "business_id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "c1fef997-3520-435f-873e-5cea287fa519", "full_address": "1000 Elm St, Atlanta, GA 30301", "submitted": true, "created_at": "2025-11-05T01:58:06Z", "updated_at": "2025-11-05T01:58:06Z", "business_id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "Jane Match", "submitted": true, "business_id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "dea47770-420c-46c7-a8f2-2d7aeda402e3", "status": "created", "business_id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:06Z", "updated_at": "2025-11-05T01:58:06Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "10c4deef-e1c4-4937-8c3e-cd0f596cc4b3", "status": "created", "business_id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "product": "litigations", "created_at": "2025-11-05T01:58:06Z", "updated_at": "2025-11-05T01:58:06Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "565a2392-118e-43d2-bb67-0d6206bf56c1", "status": "created", "business_id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "product": "bankruptcies", "created_at": "2025-11-05T01:58:06Z", "updated_at": "2025-11-05T01:58:06Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "ef379e49-7a19-4678-8dc1-c32389fd5c8f", "status": "created", "business_id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "product": "ucc_liens", "created_at": "2025-11-05T01:58:06Z", "updated_at": "2025-11-05T01:58:06Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "27077202-cefc-4f74-9861-ff7546951e18", "status": "created", "business_id": "a38870b1-fb5b-4f81-ab16-5fed36a6f804", "product": "tax_liens", "created_at": "2025-11-05T01:58:06Z", "updated_at": "2025-11-05T01:58:06Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "1000 Elm St, Atlanta, GA 30301" } ], "orders": [ {} ], "people": [ { "name": "Jane Match" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "222333444" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Tin status matches person import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Tin status matches person const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Tin status matches person package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Tin status matches person require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Tin status matches person import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Tin status matches person request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Tin status matches person using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Tin status matches person import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Tin status name mismatch **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "ffd90597-6fb4-43fb-88b5-0d0c32add116", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:58:03Z", "updated_at": "2025-11-05T01:58:03Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:03Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "ffd90597-6fb4-43fb-88b5-0d0c32add116", "tin": "11-0000099", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:03Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "a471dd31-e939-48ba-9afb-3ee720ead239", "name": "Test Company", "submitted": true, "business_id": "ffd90597-6fb4-43fb-88b5-0d0c32add116", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "ed91a475-b153-47e0-96a2-1adee3e34d68", "full_address": "700 Market St, Portland, OR 97201", "submitted": true, "created_at": "2025-11-05T01:58:03Z", "updated_at": "2025-11-05T01:58:03Z", "business_id": "ffd90597-6fb4-43fb-88b5-0d0c32add116", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "58f23a11-bbcc-41f8-a2bd-b718c58faf99", "status": "created", "business_id": "ffd90597-6fb4-43fb-88b5-0d0c32add116", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:03Z", "updated_at": "2025-11-05T01:58:03Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "e4e379c2-4393-4cf0-91af-bcc6775c12b5", "status": "created", "business_id": "ffd90597-6fb4-43fb-88b5-0d0c32add116", "product": "litigations", "created_at": "2025-11-05T01:58:03Z", "updated_at": "2025-11-05T01:58:03Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "6a817838-93fb-4082-9150-177bb213281b", "status": "created", "business_id": "ffd90597-6fb4-43fb-88b5-0d0c32add116", "product": "bankruptcies", "created_at": "2025-11-05T01:58:03Z", "updated_at": "2025-11-05T01:58:03Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "c2de65be-c012-4b8a-8386-8e18708f9aa6", "status": "created", "business_id": "ffd90597-6fb4-43fb-88b5-0d0c32add116", "product": "ucc_liens", "created_at": "2025-11-05T01:58:03Z", "updated_at": "2025-11-05T01:58:03Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "062e34a4-f5b6-444f-b416-87ed4a40f62a", "status": "created", "business_id": "ffd90597-6fb4-43fb-88b5-0d0c32add116", "product": "tax_liens", "created_at": "2025-11-05T01:58:03Z", "updated_at": "2025-11-05T01:58:03Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "700 Market St, Portland, OR 97201" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "110000099" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Tin status name mismatch import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Tin status name mismatch const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Tin status name mismatch package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Tin status name mismatch require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Tin status name mismatch import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Tin status name mismatch request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Tin status name mismatch using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Tin status name mismatch import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Tin status type ssn **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "d814a902-4ef0-4194-8e6e-4d3421fd6381", "name": "Test Company SSN", "status": "open", "created_at": "2025-11-05T01:58:07Z", "updated_at": "2025-11-05T01:58:07Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:07Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "d814a902-4ef0-4194-8e6e-4d3421fd6381", "tin": "55-5666777", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:07Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "80884147-3e75-478e-9d4c-4c1861ffc721", "name": "Test Company SSN", "submitted": true, "business_id": "d814a902-4ef0-4194-8e6e-4d3421fd6381", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "235a5b2d-3d35-42f2-b1ab-20d0b729db5d", "full_address": "1100 Maple Dr, Phoenix, AZ 85001", "submitted": true, "created_at": "2025-11-05T01:58:07Z", "updated_at": "2025-11-05T01:58:07Z", "business_id": "d814a902-4ef0-4194-8e6e-4d3421fd6381", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "59f11a7d-ec0e-4a4d-be7e-96847063490a", "status": "created", "business_id": "d814a902-4ef0-4194-8e6e-4d3421fd6381", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:07Z", "updated_at": "2025-11-05T01:58:07Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "64e9595e-6ea7-4f3c-9831-6cc301340393", "status": "created", "business_id": "d814a902-4ef0-4194-8e6e-4d3421fd6381", "product": "litigations", "created_at": "2025-11-05T01:58:07Z", "updated_at": "2025-11-05T01:58:07Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "b01c4501-1a1a-4295-9906-efeb354bd283", "status": "created", "business_id": "d814a902-4ef0-4194-8e6e-4d3421fd6381", "product": "bankruptcies", "created_at": "2025-11-05T01:58:07Z", "updated_at": "2025-11-05T01:58:07Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "721531f9-470f-4b40-a29e-62a8ae387aac", "status": "created", "business_id": "d814a902-4ef0-4194-8e6e-4d3421fd6381", "product": "ucc_liens", "created_at": "2025-11-05T01:58:07Z", "updated_at": "2025-11-05T01:58:07Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "ef36dd71-456e-42dc-b9f1-a9fd01da6abd", "status": "created", "business_id": "d814a902-4ef0-4194-8e6e-4d3421fd6381", "product": "tax_liens", "created_at": "2025-11-05T01:58:07Z", "updated_at": "2025-11-05T01:58:07Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company SSN", "name_derived": true, "addresses": [ { "full_address": "1100 Maple Dr, Phoenix, AZ 85001" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "555666777" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Tin status type ssn import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Tin status type ssn const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Tin status type ssn package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Tin status type ssn require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Tin status type ssn import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Tin status type ssn request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Tin status type ssn using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Tin status type ssn import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Tin status type ssn and ein **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "9aa5b105-7c96-4d51-b889-7cb446033e92", "name": "Test Company SSN and EIN", "status": "open", "created_at": "2025-11-05T01:58:08Z", "updated_at": "2025-11-05T01:58:08Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:08Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "9aa5b105-7c96-4d51-b889-7cb446033e92", "tin": "66-6777888", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:08Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "affa71ac-0126-489c-9cfa-09b491d25c37", "name": "Test Company SSN and EIN", "submitted": true, "business_id": "9aa5b105-7c96-4d51-b889-7cb446033e92", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "da030652-9444-4604-a58c-df696c789974", "full_address": "1200 Cedar Ln, Dallas, TX 75201", "submitted": true, "created_at": "2025-11-05T01:58:08Z", "updated_at": "2025-11-05T01:58:08Z", "business_id": "9aa5b105-7c96-4d51-b889-7cb446033e92", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "dc086497-9bec-42fe-ae1e-51daacbfc9ee", "status": "created", "business_id": "9aa5b105-7c96-4d51-b889-7cb446033e92", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:08Z", "updated_at": "2025-11-05T01:58:08Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "961353fa-f9f4-4a9f-ad30-21894b87afd7", "status": "created", "business_id": "9aa5b105-7c96-4d51-b889-7cb446033e92", "product": "litigations", "created_at": "2025-11-05T01:58:08Z", "updated_at": "2025-11-05T01:58:08Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "3b6909b7-9dfb-485b-96ad-f1d797193f1c", "status": "created", "business_id": "9aa5b105-7c96-4d51-b889-7cb446033e92", "product": "bankruptcies", "created_at": "2025-11-05T01:58:08Z", "updated_at": "2025-11-05T01:58:08Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "7231df24-3aa6-4f1a-abc0-0a846ce1f12b", "status": "created", "business_id": "9aa5b105-7c96-4d51-b889-7cb446033e92", "product": "ucc_liens", "created_at": "2025-11-05T01:58:08Z", "updated_at": "2025-11-05T01:58:08Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "4c37677c-e06c-4108-941b-50d90e529751", "status": "created", "business_id": "9aa5b105-7c96-4d51-b889-7cb446033e92", "product": "tax_liens", "created_at": "2025-11-05T01:58:08Z", "updated_at": "2025-11-05T01:58:08Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company SSN and EIN", "name_derived": true, "addresses": [ { "full_address": "1200 Cedar Ln, Dallas, TX 75201" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "666777888" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Tin status type ssn and ein import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Tin status type ssn and ein const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Tin status type ssn and ein package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Tin status type ssn and ein require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Tin status type ssn and ein import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Tin status type ssn and ein request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Tin status type ssn and ein using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Tin status type ssn and ein import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Tin status unknown issued **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "3a6c804e-51ac-4314-8273-7615326b4886", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:58:04Z", "updated_at": "2025-11-05T01:58:04Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:04Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "3a6c804e-51ac-4314-8273-7615326b4886", "tin": "11-1222333", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:04Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "2be6bec6-f1d4-4d8b-ac06-9aea02355e86", "name": "Test Company", "submitted": true, "business_id": "3a6c804e-51ac-4314-8273-7615326b4886", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "bf516e3e-2ea2-4ad1-a623-647434086afd", "full_address": "800 Pine St, Denver, CO 80202", "submitted": true, "created_at": "2025-11-05T01:58:04Z", "updated_at": "2025-11-05T01:58:04Z", "business_id": "3a6c804e-51ac-4314-8273-7615326b4886", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "3d1be8ad-eaf0-49fb-9804-e62ce7fa5361", "status": "created", "business_id": "3a6c804e-51ac-4314-8273-7615326b4886", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:04Z", "updated_at": "2025-11-05T01:58:04Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "0f9ca9a5-d2d7-4686-875f-eff04c942200", "status": "created", "business_id": "3a6c804e-51ac-4314-8273-7615326b4886", "product": "litigations", "created_at": "2025-11-05T01:58:04Z", "updated_at": "2025-11-05T01:58:04Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "d311eb89-45e9-490d-96c7-23983b0bda0c", "status": "created", "business_id": "3a6c804e-51ac-4314-8273-7615326b4886", "product": "bankruptcies", "created_at": "2025-11-05T01:58:04Z", "updated_at": "2025-11-05T01:58:04Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "d1dc6284-1655-4ce6-9f43-5308f2b55de6", "status": "created", "business_id": "3a6c804e-51ac-4314-8273-7615326b4886", "product": "ucc_liens", "created_at": "2025-11-05T01:58:04Z", "updated_at": "2025-11-05T01:58:04Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "e6b201c7-e0d5-43f4-ba7f-4d9ccfcd5a7e", "status": "created", "business_id": "3a6c804e-51ac-4314-8273-7615326b4886", "product": "tax_liens", "created_at": "2025-11-05T01:58:04Z", "updated_at": "2025-11-05T01:58:04Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "monitor": { "object": "subscription", "id": "6a438c52-2fca-47b8-9dae-a4fd20148a08", "created_at": "2025-11-05T01:58:04Z", "event_types": [ { "type": "tin.retrieved", "status": "unavailable" } ] }, "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "800 Pine St, Denver, CO 80202" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "111222333" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription": { "object": "subscription", "id": "6a438c52-2fca-47b8-9dae-a4fd20148a08" }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Tin status unknown issued import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Tin status unknown issued const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Tin status unknown issued package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Tin status unknown issued require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Tin status unknown issued import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Tin status unknown issued request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Tin status unknown issued using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Tin status unknown issued import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Tin status unknown not issued **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "fafd7ede-af2e-4190-9670-a618db2dcaba", "name": "Test Company", "status": "open", "created_at": "2025-11-05T01:58:05Z", "updated_at": "2025-11-05T01:58:05Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:05Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "fafd7ede-af2e-4190-9670-a618db2dcaba", "tin": "44-4555666", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:05Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "82fcdd58-23a2-42ae-83cc-da7564f5f817", "name": "Test Company", "submitted": true, "business_id": "fafd7ede-af2e-4190-9670-a618db2dcaba", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "1aa4e571-0a8c-4e23-b4d8-b021af83ea99", "full_address": "900 Oak Ave, Miami, FL 33101", "submitted": true, "created_at": "2025-11-05T01:58:05Z", "updated_at": "2025-11-05T01:58:05Z", "business_id": "fafd7ede-af2e-4190-9670-a618db2dcaba", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "557732fa-3cdb-47e4-9651-e25a370881a4", "status": "created", "business_id": "fafd7ede-af2e-4190-9670-a618db2dcaba", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:05Z", "updated_at": "2025-11-05T01:58:05Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "b85e7af9-d06b-41a3-9fb3-3f79cbd71738", "status": "created", "business_id": "fafd7ede-af2e-4190-9670-a618db2dcaba", "product": "litigations", "created_at": "2025-11-05T01:58:05Z", "updated_at": "2025-11-05T01:58:05Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "686af792-e812-469e-a788-df03a805aac6", "status": "created", "business_id": "fafd7ede-af2e-4190-9670-a618db2dcaba", "product": "bankruptcies", "created_at": "2025-11-05T01:58:05Z", "updated_at": "2025-11-05T01:58:05Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "aebc41b0-5aab-473c-87ef-1a00b8eb40f9", "status": "created", "business_id": "fafd7ede-af2e-4190-9670-a618db2dcaba", "product": "ucc_liens", "created_at": "2025-11-05T01:58:05Z", "updated_at": "2025-11-05T01:58:05Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "78b744c8-a7ff-456f-95be-6c2f1b4ead02", "status": "created", "business_id": "fafd7ede-af2e-4190-9670-a618db2dcaba", "product": "tax_liens", "created_at": "2025-11-05T01:58:05Z", "updated_at": "2025-11-05T01:58:05Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company", "name_derived": true, "addresses": [ { "full_address": "900 Oak Ave, Miami, FL 33101" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "444555666" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Tin status unknown not issued import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Tin status unknown not issued const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Tin status unknown not issued package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Tin status unknown not issued require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Tin status unknown not issued import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Tin status unknown not issued request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Tin status unknown not issued using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Tin status unknown not issued import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Watchlist hit **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "3a1d0628-846c-4f69-ab3b-b4056377a16f", "name": "Test Company watchlist hit", "status": "open", "created_at": "2025-11-05T01:58:10Z", "updated_at": "2025-11-05T01:58:10Z", "tags": [ "tags" ], "requester": { "id": "d903a801-88e0-441f-bc5f-49593163e755", "type": "account", "name": "Example Account", "requested_at": "2025-11-05T01:58:10Z" }, "assignee_id": "454913d6-2f79-4fc0-9234-4443f253af3c", "supported_document_types": [ "Articles of Incorporation" ], "tin": { "business_id": "3a1d0628-846c-4f69-ab3b-b4056377a16f", "tin": "12-3456789", "mismatch": false, "unknown": false, "updated_at": "2025-11-05T01:58:10Z" }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "7996b617-846c-46b6-866d-281cfa5dab43", "name": "Test Company watchlist hit", "submitted": true, "business_id": "3a1d0628-846c-4f69-ab3b-b4056377a16f", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "02811f2a-6c14-40d0-8120-bc3edbed165c", "full_address": "1400 Spruce Ave, Philadelphia, PA 19101", "submitted": true, "created_at": "2025-11-05T01:58:10Z", "updated_at": "2025-11-05T01:58:10Z", "business_id": "3a1d0628-846c-4f69-ab3b-b4056377a16f", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "not_available" }, "deliverable": false, "labels": [ "labels" ], "references": [ "references" ], "cmra": false } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "2b996b0f-cfcb-4629-b260-710da66062e2", "status": "created", "business_id": "3a1d0628-846c-4f69-ab3b-b4056377a16f", "product": "business_verification_verify", "created_at": "2025-11-05T01:58:10Z", "updated_at": "2025-11-05T01:58:10Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "9d658c74-4de5-4e18-86fc-7d46c8dc7cda", "status": "created", "business_id": "3a1d0628-846c-4f69-ab3b-b4056377a16f", "product": "litigations", "created_at": "2025-11-05T01:58:10Z", "updated_at": "2025-11-05T01:58:10Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "0afb1cb9-010c-4acb-a881-804c908da562", "status": "created", "business_id": "3a1d0628-846c-4f69-ab3b-b4056377a16f", "product": "bankruptcies", "created_at": "2025-11-05T01:58:10Z", "updated_at": "2025-11-05T01:58:10Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "e832011d-8ef2-4f1a-b1c6-178ab720e07a", "status": "created", "business_id": "3a1d0628-846c-4f69-ab3b-b4056377a16f", "product": "ucc_liens", "created_at": "2025-11-05T01:58:10Z", "updated_at": "2025-11-05T01:58:10Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } }, { "object": "order", "id": "88c2c49c-8490-40ba-869b-26bc8da09c54", "status": "created", "business_id": "3a1d0628-846c-4f69-ab3b-b4056377a16f", "product": "tax_liens", "created_at": "2025-11-05T01:58:10Z", "updated_at": "2025-11-05T01:58:10Z", "subproducts": [ "Articles of Incorporation" ], "monitoring": false, "requester": { "name": "Example Account", "type": "account" } } ], "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "submitted": { "object": "submitted_attributes", "name": "Test Company watchlist hit", "name_derived": true, "addresses": [ { "full_address": "1400 Spruce Ave, Philadelphia, PA 19101" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tin": { "tin": "123456789" }, "website": { "key": "value" }, "profiles": [ { "key": "value" } ] }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Watchlist hit import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Watchlist hit const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Watchlist hit package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Watchlist hit require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Watchlist hit import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Watchlist hit request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Watchlist hit using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Watchlist hit import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Business enrichment order **Request** ```json { "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] } ``` **Response** ```json { "object": "business", "id": "id", "name": "Dunder Mifflin Paper Company", "status": "open", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "external_id": "external_id", "unique_external_id": "unique_external_id", "tags": [ "tags" ], "requester": { "id": "id", "type": "account", "name": "name", "requested_at": "2024-01-15T09:30:00Z" }, "assignee_id": "assignee_id", "supported_document_types": [ "Articles of Incorporation" ], "review": { "object": "review", "id": "id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "tasks": [ { "category": "bankruptcies", "key": "location_frequency", "label": "Politically Exposed Persons", "message": "message", "name": "name", "status": "success", "sub_label": "sub_label", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "completed_at": "2024-01-15T09:30:00Z", "analyst_read_markdown": "analyst_read_markdown", "analyst_read_generated_at": "2024-01-15T09:30:00Z", "assignee": { "object": "user", "id": "id", "name": "name", "email": "email", "roles": [ "roles" ], "created_at": "2024-01-15T09:30:00Z", "image_url": "image_url", "directory_managed": true, "last_login_at": "2024-01-15T09:30:00Z", "settings": { "key": "value" } } }, "watchlist": { "object": "watchlist", "id": "id", "hit_count": 1, "agencies": [ { "abbr": "abbr", "name": "name", "org": "org" } ], "lists": [ { "object": "watchlist_source", "agency": "agency", "agency_abbr": "agency_abbr", "organization": "organization", "title": "title", "abbr": "abbr", "results": [ { "object": "watchlist_result", "id": "id", "status": "status", "entity_name": "entity_name", "entity_aliases": [ "entity_aliases" ], "agency_information_url": "agency_information_url", "agency_list_url": "agency_list_url", "score": null } ] } ], "people": [ { "key": "value" } ] }, "risk": { "object": "risk", "status": "completed", "level": "low", "score": 1, "latest_assessment_id": "latest_assessment_id", "reason": "reason" }, "bankruptcies": [ { "object": "bankruptcy", "id": "id", "business_id": "business_id", "case_number": "case_number", "case_updates": [ {} ], "chapter": 1.1, "court": "court", "filing_date": "2023-01-15", "debtors": [ {} ] } ], "certifications": [ { "object": "certification", "name": "name", "key": "key", "certification_type": "federal", "external_sources": [ {} ], "id": "id", "business_id": "business_id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "entrance_date": "2024-01-15T09:30:00Z", "exit_date": "2024-01-15T09:30:00Z", "certification_id": "certification_id" } ], "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z", "filing_date": "2024-01-15T09:30:00Z", "metadata": { "key": "value" } } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": "file_number", "state": "AL", "status": "created", "filing_date": "2023-01-15", "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ], "updated_date": "2023-01-15", "lapse_date": "2023-01-15", "collateral": "collateral", "collateral_type": "Blanket", "negative_pledge": true, "confirmation_number": "confirmation_number", "loan_principal_amount_cents": 1, "source": "source", "packet_number": "packet_number", "lien_termination": { "key": "value" }, "liability_cents": 1, "alternative_designation": "buyer_seller", "filed_by_account": true } ], "names": [ { "object": "name", "id": "id", "name": "Dunder Mifflin Paper Company", "submitted": true, "business_id": "business_id", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "type": "legal" } ], "addresses": [ { "object": "address", "id": "id", "full_address": "1725 Slough Avenue, Scranton, PA 18501", "submitted": true, "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "business_id": "business_id", "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "rating": { "risk_rating": "low" }, "latitude": 1.1, "longitude": 1.1, "property_type": "commercial", "deliverable": true, "street_view_available": true, "labels": [ "labels" ], "references": [ "references" ], "registered_agent_name": "registered_agent_name", "cmra": true, "location_count": 1, "is_registered_agent": true } ], "people": [ { "object": "person", "id": "id", "name": "name", "submitted": true, "business_id": "business_id", "titles": [ {} ], "people_bankruptcies": [ { "key": "value" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type" } ], "liens": [ { "object": "lien", "type": "ucc", "id": "id", "business_id": "business_id", "debtors": [ {} ], "secured_parties": [ {} ], "file_number": null, "state": "AL", "status": "created", "filing_date": null, "status_category": "active", "owner_id": "owner_id", "owner_type": "owner_type", "documents": [ { "object": "document", "id": "id", "document_type": "document_type", "filename": "filename", "content_type": "application/pdf", "size": 1, "download_url": "download_url", "created_at": "2024-01-15T09:30:00Z" } ] } ], "criminal_records": [ { "object": "criminal_history/record", "id": "id", "category": "category", "cases": [ { "object": "criminal_history/case", "charges": [ { "object": "criminal_history/charge" } ] } ] } ], "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ] } ], "phone_numbers": [ { "object": "phone_number", "id": "id", "number": "number", "contact_type": "contact_type", "recommended": true } ], "email_addresses": [ { "object": "email_address", "id": "id", "email": "email", "submitted": true, "sources": [ { "id": "id", "type": "type", "metadata": { "key": "value" } } ], "domain": "domain", "valid": true, "deliverability": "deliverability", "disposable": true, "address_type": "disposable", "business_id": "business_id", "domain_age": "2024-01-15T09:30:00Z", "first_seen": "2024-01-15T09:30:00Z", "rating": { "risk_rating": "low" } } ], "profiles": [ { "object": "profile", "id": "id", "type": "facebook", "url": "url", "external_id": "external_id", "rating": 1.1, "rating_count": 1 } ], "registrations": [ { "object": "registration", "id": "id", "business_id": "business_id", "name": "name", "status": "status", "jurisdiction": "jurisdiction", "entity_type": "entity_type", "file_number": "file_number", "state": "AL", "sub_status": "sub_status", "status_details": "status_details", "country_code": "country_code", "addresses": [ "addresses" ], "officers": [ { "key": "value" } ], "registered_agent": { "key": "value" }, "registration_date": "2023-01-15", "source": "source", "submitted": true } ], "orders": [ { "object": "order", "id": "id", "status": "created", "business_id": "business_id", "product": "identity", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "subproducts": [ "Articles of Incorporation" ], "completed_at": "2024-01-15T09:30:00Z", "monitoring": true } ], "monitor": { "object": "monitor", "id": "id", "created_at": "2024-01-15T09:30:00Z", "event_types": [ {} ] }, "tax_exempt_organization": { "object": "tax_exempt_organization", "id": "id", "ein": "ein", "name": "name", "section": "section", "ruling_date": "2023-01-15", "tax_period": "2023-01-15", "revoked_at": "2024-01-15T09:30:00Z" }, "fmcsa_registrations": [ { "object": "fmcsa_registration", "id": "id", "dot_number": "dot_number", "legal_name": "legal_name", "source": "source", "addresses": [ "addresses" ], "dba_name": "dba_name" } ], "loans": [ { "object": "loan", "id": "id", "issued_date": "2023-01-15", "amount": 1.1, "lender": "lender" } ], "litigations": [ { "object": "litigation", "id": "id", "case_name": "case_name", "case_number": "case_number", "case_status": "OPEN", "case_type": "case_type", "filing_date": "2025-06-18", "party_type": "party_type", "judgments": [ { "id": "id", "litigation_id": "litigation_id", "docket_entry_date": "2023-01-15", "text": "text", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z" } ], "jurisdiction": "jurisdiction", "jurisdiction_state": "jurisdiction_state", "parties": [ { "id": "id", "name": "name", "role": "Plaintiff", "litigation_id": "litigation_id" } ] } ], "policy_results": [ { "object": "policy_result", "id": "id", "result": "result", "created_at": "created_at", "matched": "matched", "executed": true, "name": "name", "details": { "key": "value" }, "owner_id": "owner_id", "owner_type": "owner_type", "business_id": "business_id", "type_of": "type_of", "policy_action_results": [ { "object": "policy_action_result" } ] } ], "politically_exposed_person_screening": { "object": "politically_exposed_person_screening", "id": "id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "results": [ {} ], "settings": { "people": "people", "match_score": "LOW" } }, "adverse_media_screening": { "object": "adverse_media_screening", "id": "id", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "results": [ {} ], "exclusion_settings": { "criteria_match_threshold": 1.1, "max_people_screened": 1, "max_names_screened": 1, "people": [ { "key": "value" } ] } }, "signal": { "object": "signal", "id": "id", "name": "name", "created_at": "2024-01-15T09:30:00Z", "tin": "tin", "external_id": "external_id", "model_slug": "model_slug", "score": 1.1, "business_id": "business_id", "batch_id": "batch_id", "requester": { "id": "id", "type": "type", "name": "name" }, "reasons": [ { "category": "identification", "group": "group", "description": "description", "code": "I301" } ], "addresses": [ "addresses" ], "people": [ "people" ] }, "submitted": { "object": "submitted_attributes", "name": "name", "name_derived": true, "entity_type": "entity_type", "addresses": [ { "key": "value" } ], "orders": [ {} ], "people": [ { "key": "value" } ], "phone_numbers": [ { "key": "value" } ], "email_addresses": [ { "key": "value" } ], "tags": [ "tags" ], "external_id": "external_id", "unique_external_id": "unique_external_id", "tin": { "key": "value" }, "website": { "key": "value" }, "assignee_id": "assignee_id", "formation": { "key": "value" }, "names": [ { "key": "value" } ], "profiles": [ { "key": "value" } ] }, "subscription": { "object": "subscription", "id": "id" }, "subscription_availability": { "bankruptcy": "subscribable", "certification": "subscribable", "registration": "subscribable", "tin": "subscribable", "watchlist_result": "subscribable", "lien": "subscribable" } } ``` **SDK Code** ```python Business enrichment order import requests url = "https://api.middesk.com/v1/businesses" payload = { "name": "Agent", "addresses": [{ "full_address": "369 Willow St, Phoenix, AZ 85001" }], "tin": { "tin": "123456789" }, "orders": [{ "product": "identity" }] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Business enrichment order const url = 'https://api.middesk.com/v1/businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Agent","addresses":[{"full_address":"369 Willow St, Phoenix, AZ 85001"}],"tin":{"tin":"123456789"},"orders":[{"product":"identity"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Business enrichment order package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.middesk.com/v1/businesses" payload := strings.NewReader("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Business enrichment order require 'uri' require 'net/http' url = URI("https://api.middesk.com/v1/businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Business enrichment order import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.middesk.com/v1/businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}") .asString(); ``` ```php Business enrichment order request('POST', 'https://api.middesk.com/v1/businesses', [ 'body' => '{ "name": "Agent", "addresses": [ { "full_address": "369 Willow St, Phoenix, AZ 85001" } ], "tin": { "tin": "123456789" }, "orders": [ { "product": "identity" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Business enrichment order using RestSharp; var client = new RestClient("https://api.middesk.com/v1/businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Agent\",\n \"addresses\": [\n {\n \"full_address\": \"369 Willow St, Phoenix, AZ 85001\"\n }\n ],\n \"tin\": {\n \"tin\": \"123456789\"\n },\n \"orders\": [\n {\n \"product\": \"identity\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Business enrichment order import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Agent", "addresses": [["full_address": "369 Willow St, Phoenix, AZ 85001"]], "tin": ["tin": "123456789"], "orders": [["product": "identity"]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.middesk.com/v1/businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```