Create an entity

POST /api/v1/entities

Creates a new contracting entity object.

application/json

Body

  • address object
    Hide address attributes Show address attributes
    • 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
    • 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
    • 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
      • 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
      • 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 \
 -X POST https://api.1099policy.com/api/v1/entities \
 -H "Content-Type: application/json" \
 -d '{"address":{"line1":"One Apple Park Way","locality":"Cupertino","postalcode":95014,"region":"CA"},"coverage_limit":{"aggregate_limit":200000000,"occurrence_limit":100000000},"name":"Apple, Inc","required_coverage":["general","workers-comp"]}'
Request example 
{
  "address": {
    "line1": "One Apple Park Way",
    "locality": "Cupertino",
    "postalcode": 95014,
    "region": "CA"
  },
  "coverage_limit": {
    "aggregate_limit": 200000000,
    "occurrence_limit": 100000000
  },
  "name": "Apple, Inc",
  "required_coverage": [
    "general",
    "workers-comp"
  ]
}
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"
  ]
}