Create an entity

POST /api/v1/entities

Creates a new contracting entity object.

application/json

Body

address object
Hide address attributes Show address attributes object
- country string | null
  
  2-letter country code.
- line1 string
  
  Address line 1 (Street address/PO Box).
- line2 string | null
  
  Address line 2 (Apartment/Suite/Unit/Building).
- locality string
  
  City/District/Suburb/Town/Village.
- postalcode string
  
  ZIP or postal code.
- region string
  
  2-letter state code.
coverage_limit object
Hide coverage_limit attributes Show coverage_limit attributes object
- aggregate_limit integer Required
  
  The total amount the insurance company will pay for multiple claims over the course of one policy term.
  
  A positive integer representing the aggregate limit expressed in cents (e.g., 100000000 cents to represent $1,000,000). The minimum amount is 1000 cents US.
- occurrence_limit integer Required
  
  The total amount the insurance company will pay per incident during the policy term.
  
  A positive integer representing the per occurrence limit expressed in cents (e.g., 100000000 cents to represent $1,000,000). The minimum amount is 1000 cents US.
name string Required

The contracting entity's legal name.
required_coverage object
Hide required_coverage attribute Show required_coverage attribute object
- coverage_type array[string] Required
  
  An array of coverage types that can include one or more of the following insurance coverage values: general, professional and workers-comp.
  
  Values are general, professional, or workers-comp.

Responses

201 application/json

Returns the entity object if the post succeeded.
Hide response attributes Show response attributes object
- address object
  
  Hide address attributes Show address attributes object
  
  country string | null
  
  2-letter country code.
  
  line1 string
  
  Address line 1 (Street address/PO Box).
  
  line2 string | null
  
  Address line 2 (Apartment/Suite/Unit/Building).
  
  locality string
  
  City/District/Suburb/Town/Village.
  
  postalcode string
  
  ZIP or postal code.
  
  region string
  
  2-letter state code.
- coverage_limit object
  
  The contracting entity's minimum required coverage limits.
  
  Hide coverage_limit attributes Show coverage_limit attributes object
  
  aggregate_limit integer Required
  
  The total amount the insurance company will pay for multiple claims over the course of one policy term.
  
  A positive integer representing the aggregate limit expressed in cents (e.g., 100000000 cents to represent $1,000,000). The minimum amount is 1000 cents US.
  
  occurrence_limit integer Required
  
  The total amount the insurance company will pay per incident during the policy term.
  
  A positive integer representing the per occurrence limit expressed in cents (e.g., 100000000 cents to represent $1,000,000). The minimum amount is 1000 cents US.
- created integer(int64)
  
  Time at which the object was created. Measured in seconds since the Unix epoch.
- id string
- name string
  
  The contracting entity's legal name.
- required_coverage array[string]
  
  An array of coverage types that can include one or more of the following insurance coverage values: general, professional and workers-comp.
  
  Values are general, professional, or workers-comp.

POST /api/v1/entities

curl \
 --request POST 'https://api.1099policy.com/api/v1/entities' \
 --header "Content-Type: application/json" \
 --data '{"$ref":"#/components/examples/entity"}'

Request example

{
  "$ref": "#/components/examples/entity"
}

Response examples (201)

{
  "address": {
    "country": "null",
    "line1": "92 Geary St",
    "line2": "null",
    "locality": "San Francisco",
    "postalcode": 94114,
    "region": "CA"
  },
  "coverage_limit": {
    "aggregate_limit": 200000000,
    "occurrence_limit": 100000000
  },
  "created": 1646818364,
  "id": "en_Ah3tqYn",
  "name": "Apple, Inc",
  "required_coverage": [
    "general",
    "workers-comp"
  ]
}