> ## Documentation Index
> Fetch the complete documentation index at: https://developers.projectcor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Ratecard

> Creates a new ratecard for the current company.



## OpenAPI

````yaml /api-reference/openapi.json post /ratecards
openapi: 3.1.0
info:
  title: COR API
  description: >-
    The COR API lets you integrate with projectcor.com applications using simple
    HTTP methods, in either XML or JSON formats, making this an ideal API for
    developing integrations with other softwares, external clients or mobile
    applications
  version: 1.0.0
servers:
  - url: https://api.projectcor.com/v1
    description: Production server
security:
  - bearerAuth: []
paths:
  /ratecards:
    post:
      tags:
        - Ratecards
      summary: Create a Ratecard
      description: Creates a new ratecard for the current company.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RatecardInput'
            example:
              name: Custom Ratecard 1
              original_name: Custom Ratecard 1
              percent: 15
              currency_id: 1
              linked_to_base_price: false
              external_key: BILLING-RC-001
      responses:
        '200':
          description: Ratecard created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Ratecard'
              example:
                id: 51
                original_name: Custom Ratecard 1
                name: Custom Ratecard 1
                percent: 15
                company_id: 2336
                system: false
                created_at: '2025-12-15 00:24:41'
                updated_at: '2025-12-15 00:24:41'
                deleted_at: null
                external_key: BILLING-RC-001
                currency_id: 1
                linked_to_base_price: false
components:
  schemas:
    RatecardInput:
      type: object
      required:
        - name
      description: Input schema for creating a new ratecard
      properties:
        name:
          type: string
          description: Display name of the ratecard
        original_name:
          type: string
          description: Original/system name of the ratecard (usually same as name)
        percent:
          type: number
          description: Percentage applied by this ratecard (e.g., 0, 10, 15)
        currency_id:
          type: integer
          description: >-
            Associated currency ID. Defaults to the system's base currency if
            not specified.
        linked_to_base_price:
          type: boolean
          description: Whether the ratecard should be calculated based on base price
        external_key:
          type: string
          description: External key for integration with external systems
    Ratecard:
      type: object
      description: A ratecard defines pricing configurations for the company
      properties:
        id:
          type: integer
          description: Unique identifier for the ratecard
        name:
          type: string
          description: Display name of the ratecard
        original_name:
          type: string
          description: Original/system name of the ratecard
        percent:
          type: number
          description: Percentage applied by this ratecard
        company_id:
          type: integer
          description: Company ID that owns this ratecard
        system:
          type: boolean
          description: Whether this is a system-generated ratecard
        currency_id:
          type:
            - integer
            - 'null'
          description: >-
            Associated currency ID. Defaults to the system's base currency if
            not specified.
        linked_to_base_price:
          type: boolean
          description: Whether the ratecard is calculated based on base price
        external_key:
          type:
            - string
            - 'null'
          description: External key for integration with external systems
        created_at:
          type: string
          format: date-time
          description: Creation timestamp
        updated_at:
          type: string
          format: date-time
          description: Last update timestamp
        deleted_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Deletion timestamp (soft delete)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````