--- title: "Create an entity" method: POST path: "/entities" tags: ["Entities"] --- # Create an entity `POST /entities` ## Request - Base URL: `https://api.sandbox.monite.com/v1` - URL: `https://api.sandbox.monite.com/v1/entities` - Auth: HTTP bearer Create a new entity from the specified values. ## Headers - `x-monite-version` string, required ## Request body - object - `address` EntityAddressSchema, required: A schema represents address info of the entity - `city` string, required: A city (a full name) where the entity is registered - `country` 'AF' | 'AX' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'IC' | 'CV' | 'KY' | 'CF' | 'EA' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'AN' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'SS' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'BL' | 'BQ' | 'CW' | 'MF' | 'SX', required - `line1` string, required: A street where the entity is registered - `line2` string: An alternative street used by the entity - `postal_code` string, required: A postal code of the address where the entity is registered - `state` string: State, county, province, prefecture, region, or similar component of the entity's address. For US entities, `state` is required and must be a two-letter [USPS state abbreviation](https://pe.usps.com/text/pub28/28apb.htm), for example, NY or CA. - `email` string, email, required: An official email address of the entity - `individual` IndividualSchema: A schema contains metadata for an individual - `date_of_birth` string, date - `first_name` string, required: A first name of an individual - `id_number` string - `last_name` string, required: A last name of an individual - `ssn_last_4` string: The last four digits of the individual's Social Security number - `title` string: A title of an individual - `organization` OrganizationSchema: A schema contains metadata for an organization - `business_structure` 'incorporated_partnership' | 'unincorporated_partnership' | 'public_corporation' | 'private_corporation' | 'sole_proprietorship' | 'single_member_llc' | 'multi_member_llc' | 'private_partnership' | 'unincorporated_association' | 'public_partnership' - `directors_provided` boolean - `executives_provided` boolean - `legal_entity_id` string: A code which identifies uniquely a party of a transaction worldwide - `legal_name` string, required: The legal name of the organization. If this organization will use Monite payment rails, this name must be up to 100 characters long, otherwise it can be up to 255 characters long. - `owners_provided` boolean - `representative_provided` boolean - `phone` string: The contact phone number of the entity. Required for US organizations to use payments. - `registration_authority` string: (Germany only) The name of the local district court (_Amtsgericht_) where the entity is registered. Required if `registration_number` is provided. - `registration_number` string: (Germany only) The entity's commercial register number (_Handelsregisternummer_) in the German Commercial Register, if available. - `tax_id` string: The entity's taxpayer identification number or tax ID. This field is required for entities that are non-VAT registered. - `type` 'individual' | 'organization', required - `website` string, uri: A website of the entity ## Response `201` Successful Response - union: A schema for a response after creation of an entity of different types - object - `type` 'individual', required: Discriminator value: individual - `id` string, uuid, required: UUID entity ID - `created_at` string, date-time, required: UTC datetime - `updated_at` string, date-time, required: UTC datetime - `address` EntityAddressResponseSchema, required: A schema represents address info of the entity - `city` string, required: A city (a full name) where the entity is registered - `country` 'AF' | 'AX' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'IC' | 'CV' | 'KY' | 'CF' | 'EA' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'AN' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'SS' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'BL' | 'BQ' | 'CW' | 'MF' | 'SX', required - `line1` string, required: A street where the entity is registered - `line2` string: An alternative street used by the entity - `postal_code` string, required: A postal code of the address where the entity is registered - `state` string: A state in a country where the entity is registered - `email` string: An official email address of the entity - `individual` IndividualResponseSchema, required: Contains data specific to entities of the `individual` type. - `date_of_birth` string, date - `first_name` string, required: A first name of an individual - `id_number` string - `last_name` string, required: A last name of an individual - `ssn_last_4` string: The last four digits of the individual's Social Security number - `title` string: A title of an individual - `logo` FileSchema2: Represents a file (such as a PDF invoice) that was uploaded to Monite. - `id` string, uuid, required: A unique ID of this file. - `created_at` string, date-time, required: UTC date and time when this file was uploaded to Monite. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `file_type` string, required: The type of the business object associated with this file. - `md5` string, required: The MD5 hash of the file. - `mimetype` string, required: The file's [media type](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types). - `name` string, required: The original file name (if available). - `pages` PageSchema[]: If the file is a PDF document, this property contains individual pages extracted from the file. Otherwise, an empty array. - `id` string, uuid, required: A unique ID of the image. - `mimetype` string, required: The [media type](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types) of the image. - `number` integer, required: The page number in the PDF document, from 0. - `size` integer, required: Image file size, in bytes. - `url` string, required: The URL to download the image. - `previews` PreviewSchema[]: Preview images generated for this file. There can be multiple images with different sizes. - `height` integer, required: The image height in pixels. - `url` string, required: The image URL. - `width` integer, required: The image width in pixels. - `region` string, required: Geographical region of the data center where the file is stored. - `size` integer, required: The file size in bytes. - `url` string, required: The URL to download the file. - `phone` string: A phone number of the entity - `registration_authority` string: (Germany only) The name of the local district court (_Amtsgericht_) where the entity is registered. Required if `registration_number` is provided. - `registration_number` string: (Germany only) The entity's commercial register number (_Handelsregisternummer_) in the German Commercial Register, if available. - `status` 'active' | 'deleted', required - `tax_id` string: The entity's taxpayer identification number or tax ID. This field is required for entities that are non-VAT registered. - `website` string, uri: A website of the entity - object - `type` 'organization', required: Discriminator value: organization - `id` string, uuid, required: UUID entity ID - `created_at` string, date-time, required: UTC datetime - `updated_at` string, date-time, required: UTC datetime - `address` EntityAddressResponseSchema, required: A schema represents address info of the entity - `city` string, required: A city (a full name) where the entity is registered - `country` 'AF' | 'AX' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'IC' | 'CV' | 'KY' | 'CF' | 'EA' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'AN' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'SS' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'BL' | 'BQ' | 'CW' | 'MF' | 'SX', required - `line1` string, required: A street where the entity is registered - `line2` string: An alternative street used by the entity - `postal_code` string, required: A postal code of the address where the entity is registered - `state` string: A state in a country where the entity is registered - `email` string: An official email address of the entity - `logo` FileSchema2: Represents a file (such as a PDF invoice) that was uploaded to Monite. - `id` string, uuid, required: A unique ID of this file. - `created_at` string, date-time, required: UTC date and time when this file was uploaded to Monite. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `file_type` string, required: The type of the business object associated with this file. - `md5` string, required: The MD5 hash of the file. - `mimetype` string, required: The file's [media type](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types). - `name` string, required: The original file name (if available). - `pages` PageSchema[]: If the file is a PDF document, this property contains individual pages extracted from the file. Otherwise, an empty array. - `id` string, uuid, required: A unique ID of the image. - `mimetype` string, required: The [media type](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types) of the image. - `number` integer, required: The page number in the PDF document, from 0. - `size` integer, required: Image file size, in bytes. - `url` string, required: The URL to download the image. - `previews` PreviewSchema[]: Preview images generated for this file. There can be multiple images with different sizes. - `height` integer, required: The image height in pixels. - `url` string, required: The image URL. - `width` integer, required: The image width in pixels. - `region` string, required: Geographical region of the data center where the file is stored. - `size` integer, required: The file size in bytes. - `url` string, required: The URL to download the file. - `organization` OrganizationResponseSchema, required: Contains data specific to entities of the `organization` type. - `business_structure` 'incorporated_partnership' | 'unincorporated_partnership' | 'public_corporation' | 'private_corporation' | 'sole_proprietorship' | 'single_member_llc' | 'multi_member_llc' | 'private_partnership' | 'unincorporated_association' | 'public_partnership' - `directors_provided` boolean - `executives_provided` boolean - `legal_entity_id` string: A code which identifies uniquely a party of a transaction worldwide - `legal_name` string, required: The legal name of the organization. - `owners_provided` boolean - `representative_provided` boolean - `phone` string: A phone number of the entity - `registration_authority` string: (Germany only) The name of the local district court (_Amtsgericht_) where the entity is registered. Required if `registration_number` is provided. - `registration_number` string: (Germany only) The entity's commercial register number (_Handelsregisternummer_) in the German Commercial Register, if available. - `status` 'active' | 'deleted', required - `tax_id` string: The entity's taxpayer identification number or tax ID. This field is required for entities that are non-VAT registered. - `website` string, uri: A website of the entity ## Other responses - `400`: Bad Request - `403`: Forbidden - `422`: Validation Error - `500`: Internal Server Error --- [API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)