---
title: "Create Estimate"
method: POST
path: "/{estimates-type}.json"
tags: ["Estimates"]
---

# Create Estimate

`POST /{estimates-type}.json`

Creates a new quote, proforma or fees_note.

## Path parameters

- `estimates-type` 'quotes' | 'proformas' | 'fees_notes', required

## Query parameters

- `api_key` string, required

## Request body

- EstimateCreateRequest
  - `quote` object, required
    - `date` string — dd/mm/yyyy
    - `due_date` string — dd/mm/yyyy
    - `reference` string
    - `observations` string
    - `retention` string
    - `tax_exemption` string
    - `sequence_id` string
    - `manual_sequence_number` string
    - `client` InvoicesClientRequest, required — Client Details.
      - `name` string, required
      - `code` string, required
      - `email` string
      - `address` string
      - `city` string
      - `postal_code` string
      - `fiscal_id` string
      - `country` string
      - `website` string
      - `phone` string
      - `fax` string
      - `observations` string
    - `items` EstimatesItemRequest[], required
      - `name` string, required
      - `description` string, required
      - `unit_price` number, required
      - `quantity` number, required
      - `unit` string
      - `discount` number
      - `tax` EstimatesTaxRequest
        - `name` string
    - `mb_reference` '0' | '1'
    - `auto_add_related_document` string
    - `tax_exemption_reason` string

## Response `201`

SUCCESS 

Creates a new quote, proforma or fees_note.

#### Possible values for field atcud:

* ABCD1234-1 (or similar) - Unique document identifier to the Tax Authority, when the sequence is registered.
* N/D - The document's sequence is relevant for ATCUD but is not registered in the Tax Authority.
* N/A - The document's sequence is not relevant for ATCUD and is not registered in the Tax Authority.

- EstimateGetResponse
  - `quote` object
    - `id` integer
    - `status` string
    - `archived` boolean
    - `type` string
    - `sequence_number` string
    - `inverted_sequence_number` string
    - `atcud` string
    - `date` string
    - `due_date` string
    - `reference` string
    - `observations` string
    - `retention` string
    - `permalink` string
    - `saft_hash` string
    - `sum` number
    - `discount` number
    - `before_taxes` number
    - `taxes` number
    - `total` number
    - `currency` string
    - `sequence_id` string
    - `tax_exemption` string
    - `client` InvoiceClient
      - `id` integer
      - `name` string
      - `code` string
      - `country` string
      - `email` string
    - `items` InvoiceItem[]
      - `name` string
      - `description` string
      - `unit_price` number
      - `quantity` number
      - `unit` string
      - `discount` number
      - `tax` object
        - `name` string
        - `value` number
      - `total` number

## Other responses

- `401` — ACCESS DENIED
- `422` — UNPROCESSABLE ENTITY

---

[API](https://skmtc.net/invoicexpress/apis/invoicexpress-api.md) · [All operations](https://skmtc.net/invoicexpress/apis/invoicexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invoicexpress/invoicexpress-api/versions/5cea7e1d8f41/schema)