Index - Cirqll Core

This endpoint allows you to fetch all the chances with additional filters

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Query Params

with[]

array[string] | null

optional

Eager load related items

See parameters for more info

Example:

["customer","user"]

show[]

array[string] | null

optional

Select specific fields to show in the response object

See parameters for more info

Example:

["name","id","price"]

order_by[]

array[string] | null

optional

Order the data by one or more fields

You can either order ascendingly or descendingly by using asc and desc. The default order_by is id:asc. Nested items are not supported. See parameters for more info.

Example:

["id:desc","name","price:asc"]

filter

string | null

optional

Filter the results with a filter query like field:operator:value

See parameters for more info

Example:

customer_id:in:28;29;30

limit

integer

optional

Specify how many items you want to fetch at a time

Example:

100

offset

integer

optional

To fetch more than limit you need to increment this offset value each time you make a follow-up request.

Example:

Header Params

string

optional

Default:

application/json

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

data

array[object (Chance) {12}]

required

The items

integer <uint32>

read-onlyrequired

Unique identifier of entity

>= 1<= 4294967296

Example:

name

string <char>

required

Name of the chance

>= 0 characters<= 255 characters

price

number <float>

required

Value of the chance, is used for the financial dashboard to get your earnings in the selected date frame

>= 0

description

string <char>

optional

Description which can be left to inform other colleagues of the progress or give context

<= 65535 characters

percentage

integer <int32>

required

Succesrate percentage of a chance completing

>= 0<= 100

customer_id

integer <uint32>

required

customer

object

Customer

read-onlyoptional

user_id

integer <uint32>

required

user

object

User

optional

created_at

string <date-time>

read-onlyrequired

Date at which the entity was created

Example:

2024-05-18 13:38:35

updated_at

string <date-time>

read-onlyrequired

Date at which the entity was last changed

Example:

2024-05-18 13:38:35

archived_at

string <date-time> | null

required

limit

integer <uint>

required

The maximum amount of items that were fetched

The actual count of the data may be lower than this number

>= 1

Default:

100

total

integer <uint>

required

The total number of items that exist

filter is taken into account

>= 0

offset

integer <uint>

required

The item offset

If total is more than the limit, then the offset is used to fetch the other pages. pages=total/limit, to get page 3 use offset=total/limit*3

>= 0

Default:

Example

{
  "data": [
    {
      "id": 1,
      "name": "string",
      "price": 0,
      "description": "string",
      "percentage": 0,
      "customer_id": 0,
      "customer": {
        "id": 1,
        "name": "string",
        "next_contact": "2019-08-24T14:15:22Z",
        "email": "cleora42@gmail.com",
        "phone": "1-848-429-9425",
        "show_on_map": true,
        "coc": "string",
        "description": "string",
        "user_id": 0,
        "user": {
          "id": 1,
          "name": "Casey Dach",
          "email": "string",
          "created_at": "2024-05-18 13:38:35",
          "updated_at": "2024-05-18 13:38:35",
          "company_id": 0,
          "company": {
            "id": 1,
            "name": "string",
            "phone": "1-310-793-5469",
            "coc": "string",
            "financial_goal": 0,
            "address_id": 0,
            "address": {
              "id": 1,
              "street": "Georgianna Loop",
              "house_number": 12,
              "addition": "A",
              "zipcode": "45668",
              "city": "Lake Quentinmouth",
              "province": "DR",
              "country": "NL",
              "extra_address_line_one": "string",
              "extra_address_line_two": "string",
              "lat": 0,
              "lon": 0,
              "created_at": "2024-05-18 13:38:35",
              "updated_at": "2024-05-18 13:38:35"
            },
            "created_at": "2024-05-18 13:38:35",
            "updated_at": "2024-05-18 13:38:35"
          }
        },
        "address_id": 0,
        "address": {
          "id": 1,
          "street": "Georgianna Loop",
          "house_number": 12,
          "addition": "A",
          "zipcode": "45668",
          "city": "Lake Quentinmouth",
          "province": "DR",
          "country": "NL",
          "extra_address_line_one": "string",
          "extra_address_line_two": "string",
          "lat": 0,
          "lon": 0,
          "created_at": "2024-05-18 13:38:35",
          "updated_at": "2024-05-18 13:38:35"
        },
        "created_at": "2024-05-18 13:38:35",
        "updated_at": "2024-05-18 13:38:35"
      },
      "user_id": 0,
      "user": {
        "id": 1,
        "name": "Casey Dach",
        "email": "string",
        "created_at": "2024-05-18 13:38:35",
        "updated_at": "2024-05-18 13:38:35",
        "company_id": 0,
        "company": {
          "id": 1,
          "name": "string",
          "phone": "1-310-793-5469",
          "coc": "string",
          "financial_goal": 0,
          "address_id": 0,
          "address": {
            "id": 1,
            "street": "Georgianna Loop",
            "house_number": 12,
            "addition": "A",
            "zipcode": "45668",
            "city": "Lake Quentinmouth",
            "province": "DR",
            "country": "NL",
            "extra_address_line_one": "string",
            "extra_address_line_two": "string",
            "lat": 0,
            "lon": 0,
            "created_at": "2024-05-18 13:38:35",
            "updated_at": "2024-05-18 13:38:35"
          },
          "created_at": "2024-05-18 13:38:35",
          "updated_at": "2024-05-18 13:38:35"
        }
      },
      "created_at": "2024-05-18 13:38:35",
      "updated_at": "2024-05-18 13:38:35",
      "archived_at": "2019-08-24T14:15:22Z"
    }
  ],
  "limit": 100,
  "total": 0,
  "offset": 0
}

🟠401Not Logged In

🔴500Server Error