# Create Travel Data Items

Accepts trip records with nested activities for travel data ingestion.

Endpoint: POST /v2/travel-data
Security: Bearer-Auth

## Request fields (application/json):

  - `trips` (array)

  - `trips.audit_for` (string)
    UUID of the Auditable entity this trip is audited for.

  - `trips.booking_id` (string)

  - `trips.booking_provider` (string)

  - `trips.currency` (string)
    3-letter ISO 4217 alpha code of the currency.
    Enum: "AED", "AMD", "ARS", "AUD", "AZN", "BAM", "BGN", "BHD", "BRL", "CAD", "CHF", "CLP", "CNY", "COP", "CRC", "CZK", "DKK", "DZD", "EGP", "ETB", "EUR", "GBP", "GEL", "HKD", "HUF", "IDR", "INR", "ISK", "JMD", "JOD", "JPY", "KES", "KRW", "KWD", "KZT", "LKR", "LYD", "MAD", "MUR", "MXN", "MYR", "NOK", "NZD", "OMR", "PHP", "PKR", "PLN", "QAR", "RSD", "RUB", "SAR", "SEK", "SGD", "SYP", "THB", "TND", "TRY", "TTD", "TWD", "UAH", "USD", "VND", "XAF", "XOF", "ZAR"

  - `trips.amount_in_cents` (integer)

  - `trips.metadata` (object)
    Metadata associated with the trip, Key-Value pairs.

  - `trips.start_date_utc` (string, required)
    Date in ISO 8601 notation.

  - `trips.end_date_utc` (string)
    Date in ISO 8601 notation.

  - `trips.external_source_id` (string)
    ID of the trip in the external system that created this trip.

  - `trips.external_source` (string)
    Name of the external system that created this trip.

  - `trips.external_created_at` (string)
    Date in ISO 8601 notation.

  - `trips.pnr` (string)
    Passenger Name Record, commonly used in flight bookings.

  - `trips.trip_name` (string)

  - `trips.trip_purpose` (string)

  - `trips.trip_reference` (string)
    If given, this field must be unique. An API call with the same trip_reference will attach new activities to the existing trip instead of creating a new trip.

  - `trips.trip_status` (string)

  - `trips.activities` (array, required)

  - `trips.cost_center` (object)
    Cost center associated with a trip.

  - `trips.cost_center.department` (string)
    Department associated with the cost center. This field is optional, but if provided will be avaialble as a filter option in the UI.

  - `trips.cost_center.email` (string, required)

  - `trips.cost_center.name` (string, required)

  - `trips.cost_center.purpose` (string)

## Response 200 fields (application/json):

  - `carbon_quantity` (number, required)
    Total carbon quantity aggregated across all items

  - `carbon_unit` (string, required)
    SQUAKE uses The International System of Units (SI), commonly referred to as "metric system".
    Enum: "tonne", "kilogram", "gram"

  - `items` (array)

  - `items.carbon_quantity` (number, required)

  - `items.external_reference` (string,null)

  - `items.type` (string, required)
    Enum: "accommodation", "air_freight", "bus", "camping_site", "car", "co2_amount", "coffee_production", "cruise", "expenditure", "ferry", "flight", "general", "hotel", "logistics", "logistics_site", "money_amount", "private_jet", "sea_freight", "inland_waterways", "train", "rail_freight", "road_freight", "van"

  - `items.methodology` (object)

  - `items.methodology.errors` (array)

  - `items.methodology.errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type"

  - `items.methodology.errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `items.methodology.errors.source` (object)
    An object containing references to the primary source of the error

  - `items.methodology.errors.source.id` (string)

  - `items.methodology.errors.source.attribute` (string, required)

  - `items.methodology.errors.source.model` (string)

  - `items.methodology.carbon` (object)

  - `items.methodology.carbon.quantity` (any, required)

  - `items.methodology.carbon.unit` (string, required)
    SQUAKE uses The International System of Units (SI), commonly referred to as "metric system".
    Enum: "tonne", "kilogram", "gram"

  - `items.methodology.distance` (object)

  - `items.methodology.distance.unit` (string, required)
    SQUAKE uses common distance units
    Enum: "meter", "kilometer", "feet", "mile", "nautical_mile"

  - `items.methodology.original_distance` (object)

  - `items.methodology.emission_factors` (object)

  - `items.methodology.emission_factors.co2_per_km_grams` (any)

  - `items.methodology.emission_factors.energy_scope` (string)
    ttw - Tank-to-Wheel

wtw - Well-to-Wheel
    Enum: "ttw", "wtw"

  - `items.methodology.meta` (object)

  - `items.distance_unit` (string)
    SQUAKE uses common distance units
    Enum: "meter", "kilometer", "feet", "mile", "nautical_mile"

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)


## Response 500 fields