List Eoi Responses

curl --request GET \
  --url https://api.zivio.net/api/v4/eoi_responses \
  --header 'Authorization: Bearer <token>' \
  --header 'zivio-tenant-id: <api-key>'

import requests

url = "https://api.zivio.net/api/v4/eoi_responses"

headers = {
    "Authorization": "Bearer <token>",
    "zivio-tenant-id": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'zivio-tenant-id': '<api-key>'}
};

fetch('https://api.zivio.net/api/v4/eoi_responses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zivio.net/api/v4/eoi_responses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "zivio-tenant-id: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zivio.net/api/v4/eoi_responses"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("zivio-tenant-id", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zivio.net/api/v4/eoi_responses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["zivio-tenant-id"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "eoi_responses": [
    {
      "id": 101,
      "proposal": "Example proposal",
      "supplier": {
        "id": 101,
        "name": "Acme Corporation",
        "email": "user1@example.com",
        "vetting_status": "PASSED",
        "tax_number": "Example tax_number",
        "tax_registered": true
      },
      "eoi": {
        "id": 101,
        "title": "Website Redesign Project",
        "description": "Complete redesign of corporate website with modern UX",
        "status": "pending",
        "submission_deadline": "2024-01-16T10:30:00+00:00",
        "skills": [
          {
            "id": 101,
            "name": "Acme Corporation",
            "slug": "Example slug"
          },
          {
            "id": 102,
            "name": "Global Services Ltd",
            "slug": "Example slug"
          }
        ],
        "owner": {
          "id": 101,
          "first_name": "Demo",
          "last_name": "User",
          "email": "user1@example.com",
          "org_id": 501,
          "org_name": "Acme Corporation"
        },
        "client_org": {
          "id": 101,
          "name": "Acme Corporation",
          "is_external_client": true
        },
        "skill_category": {
          "id": 101,
          "name": "Acme Corporation",
          "code": "Example code",
          "slug": "Example slug",
          "precedence": 101,
          "parent_id": 501,
          "parent_name": "Example parent_name",
          "parent_slug": "Example parent_slug"
        },
        "skill_subcategory": {
          "id": 101,
          "name": "Acme Corporation",
          "code": "Example code",
          "slug": "Example slug",
          "precedence": 101,
          "parent_id": 501,
          "parent_name": "Example parent_name",
          "parent_slug": "Example parent_slug"
        }
      },
      "shortlisted_at": "2024-01-16T10:30:00+00:00",
      "rejected_at": "2024-01-16T10:30:00+00:00",
      "created_at": "2024-01-16T10:30:00+00:00",
      "updated_at": "2024-01-16T10:30:00+00:00"
    },
    {
      "id": 102,
      "proposal": "Example proposal",
      "supplier": {
        "id": 102,
        "name": "Global Services Ltd",
        "email": "user2@example.com",
        "vetting_status": "FAILED",
        "tax_number": "Example tax_number",
        "tax_registered": true
      },
      "eoi": {
        "id": 102,
        "title": "Mobile App Development",
        "description": "Native iOS and Android application",
        "status": "rejected",
        "submission_deadline": "2024-01-17T10:30:00+00:00",
        "skills": [
          {
            "id": 102,
            "name": "Global Services Ltd",
            "slug": "Example slug"
          },
          {
            "id": 103,
            "name": "Global Services Ltd",
            "slug": "Example slug"
          }
        ],
        "owner": {
          "id": 102,
          "first_name": "Jane",
          "last_name": "Smith",
          "email": "user2@example.com",
          "org_id": 502,
          "org_name": "Global Services Ltd"
        },
        "client_org": {
          "id": 102,
          "name": "Global Services Ltd",
          "is_external_client": true
        },
        "skill_category": {
          "id": 102,
          "name": "Global Services Ltd",
          "code": "Example code",
          "slug": "Example slug",
          "precedence": 102,
          "parent_id": 502,
          "parent_name": "Example parent_name",
          "parent_slug": "Example parent_slug"
        },
        "skill_subcategory": {
          "id": 102,
          "name": "Global Services Ltd",
          "code": "Example code",
          "slug": "Example slug",
          "precedence": 102,
          "parent_id": 502,
          "parent_name": "Example parent_name",
          "parent_slug": "Example parent_slug"
        }
      },
      "shortlisted_at": "2024-01-17T10:30:00+00:00",
      "rejected_at": "2024-01-17T10:30:00+00:00",
      "created_at": "2024-01-17T10:30:00+00:00",
      "updated_at": "2024-01-17T10:30:00+00:00"
    }
  ]
}

Eoi Responses

List Eoi Responses

Retrieve a paginated list of eoi_responses. Use filters to narrow results.

Filtering

Use the filter[<attribute>] parameter to filter results. Multiple filters are combined with AND logic.

Basic Examples

# Equality (implicit)
GET /api/v4/eoi_responses?filter[proposal]=active

# Multiple values (implicit IN)
GET /api/v4/eoi_responses?filter[proposal]=draft,pending

# With explicit operator
GET /api/v4/eoi_responses?filter[created_at][gte]=2024-01-01

# Range query
GET /api/v4/eoi_responses?filter[eoi_id][between]=10,100

# Multiple filters (AND)
GET /api/v4/eoi_responses?filter[proposal]=active&filter[eoi_id][gte]=10

Available Attributes

Attribute	Type	Operators	Permitted Values
created_at	datetime	`eq`, `not_eq`, `gt`, `gte`, `lt`, `lte`, `between`	-
eoi_id	integer	`eq`, `not_eq`, `in`, `not_in`, `gt`, `gte`, `lt`, `lte`, `between`	-
id	integer	`eq`, `not_eq`, `in`, `not_in`, `gt`, `gte`, `lt`, `lte`, `between`	-
proposal	string	`eq`, `not_eq`, `in`, `not_in`, `like`, `not_like`	-
rejected_at	datetime	`eq`, `not_eq`, `gt`, `gte`, `lt`, `lte`, `between`	-
shortlisted_at	datetime	`eq`, `not_eq`, `gt`, `gte`, `lt`, `lte`, `between`	-
supplier_id	integer	`eq`, `not_eq`, `in`, `not_in`, `gt`, `gte`, `lt`, `lte`, `between`	-
updated_at	datetime	`eq`, `not_eq`, `gt`, `gte`, `lt`, `lte`, `between`	-

OR Conditions

Use or[group] to combine filter groups with OR logic. Filters within a group are ANDed:

# Simple OR
GET /api/v4/eoi_responses?or[1][proposal]=pending&or[2][proposal]=active

# Complex OR (proposal=pending AND eoi_id>=10) OR (proposal=active)
GET /api/v4/eoi_responses?or[1][proposal]=pending&or[1][eoi_id][gte]=10&or[2][proposal]=active

Sorting

Use sort[<attribute>] to order results. Default direction is ascending.

# Ascending (implicit)
GET /api/v4/eoi_responses?sort[created_at]=

# Descending
GET /api/v4/eoi_responses?sort[created_at]=desc

# Combined with filters
GET /api/v4/eoi_responses?filter[proposal]=active&sort[created_at]=desc

GET

eoi_responses

List Eoi Responses

curl --request GET \
  --url https://api.zivio.net/api/v4/eoi_responses \
  --header 'Authorization: Bearer <token>' \
  --header 'zivio-tenant-id: <api-key>'

import requests

url = "https://api.zivio.net/api/v4/eoi_responses"

headers = {
    "Authorization": "Bearer <token>",
    "zivio-tenant-id": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'zivio-tenant-id': '<api-key>'}
};

fetch('https://api.zivio.net/api/v4/eoi_responses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zivio.net/api/v4/eoi_responses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "zivio-tenant-id: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zivio.net/api/v4/eoi_responses"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("zivio-tenant-id", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zivio.net/api/v4/eoi_responses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["zivio-tenant-id"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "eoi_responses": [
    {
      "id": 101,
      "proposal": "Example proposal",
      "supplier": {
        "id": 101,
        "name": "Acme Corporation",
        "email": "user1@example.com",
        "vetting_status": "PASSED",
        "tax_number": "Example tax_number",
        "tax_registered": true
      },
      "eoi": {
        "id": 101,
        "title": "Website Redesign Project",
        "description": "Complete redesign of corporate website with modern UX",
        "status": "pending",
        "submission_deadline": "2024-01-16T10:30:00+00:00",
        "skills": [
          {
            "id": 101,
            "name": "Acme Corporation",
            "slug": "Example slug"
          },
          {
            "id": 102,
            "name": "Global Services Ltd",
            "slug": "Example slug"
          }
        ],
        "owner": {
          "id": 101,
          "first_name": "Demo",
          "last_name": "User",
          "email": "user1@example.com",
          "org_id": 501,
          "org_name": "Acme Corporation"
        },
        "client_org": {
          "id": 101,
          "name": "Acme Corporation",
          "is_external_client": true
        },
        "skill_category": {
          "id": 101,
          "name": "Acme Corporation",
          "code": "Example code",
          "slug": "Example slug",
          "precedence": 101,
          "parent_id": 501,
          "parent_name": "Example parent_name",
          "parent_slug": "Example parent_slug"
        },
        "skill_subcategory": {
          "id": 101,
          "name": "Acme Corporation",
          "code": "Example code",
          "slug": "Example slug",
          "precedence": 101,
          "parent_id": 501,
          "parent_name": "Example parent_name",
          "parent_slug": "Example parent_slug"
        }
      },
      "shortlisted_at": "2024-01-16T10:30:00+00:00",
      "rejected_at": "2024-01-16T10:30:00+00:00",
      "created_at": "2024-01-16T10:30:00+00:00",
      "updated_at": "2024-01-16T10:30:00+00:00"
    },
    {
      "id": 102,
      "proposal": "Example proposal",
      "supplier": {
        "id": 102,
        "name": "Global Services Ltd",
        "email": "user2@example.com",
        "vetting_status": "FAILED",
        "tax_number": "Example tax_number",
        "tax_registered": true
      },
      "eoi": {
        "id": 102,
        "title": "Mobile App Development",
        "description": "Native iOS and Android application",
        "status": "rejected",
        "submission_deadline": "2024-01-17T10:30:00+00:00",
        "skills": [
          {
            "id": 102,
            "name": "Global Services Ltd",
            "slug": "Example slug"
          },
          {
            "id": 103,
            "name": "Global Services Ltd",
            "slug": "Example slug"
          }
        ],
        "owner": {
          "id": 102,
          "first_name": "Jane",
          "last_name": "Smith",
          "email": "user2@example.com",
          "org_id": 502,
          "org_name": "Global Services Ltd"
        },
        "client_org": {
          "id": 102,
          "name": "Global Services Ltd",
          "is_external_client": true
        },
        "skill_category": {
          "id": 102,
          "name": "Global Services Ltd",
          "code": "Example code",
          "slug": "Example slug",
          "precedence": 102,
          "parent_id": 502,
          "parent_name": "Example parent_name",
          "parent_slug": "Example parent_slug"
        },
        "skill_subcategory": {
          "id": 102,
          "name": "Global Services Ltd",
          "code": "Example code",
          "slug": "Example slug",
          "precedence": 102,
          "parent_id": 502,
          "parent_name": "Example parent_name",
          "parent_slug": "Example parent_slug"
        }
      },
      "shortlisted_at": "2024-01-17T10:30:00+00:00",
      "rejected_at": "2024-01-17T10:30:00+00:00",
      "created_at": "2024-01-17T10:30:00+00:00",
      "updated_at": "2024-01-17T10:30:00+00:00"
    }
  ]
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client credentials. The access token from POST /oauth/token is sent as a bearer token. Request only the scopes you need.

zivio-tenant-id

string

header

required

Your Zivio organisation identifier. The regional API endpoints serve every Zivio organisation, so each request must identify yours.

Query Parameters

page

integer

default:1

Page number for pagination

limit

integer

default:20

Number of results per page (max 100)

Required range: x <= 100

filter[<attribute>]

object

Filterable attributes:

integer (operators: eq, not_eq, in, not_in, gt, gte, lt, lte, between): eoi_id, id, supplier_id datetime (operators: eq, not_eq, gt, gte, lt, lte, between): created_at, rejected_at, shortlisted_at, updated_at string (operators: eq, not_eq, in, not_in, like, not_like): proposal

Note: like is a case-insensitive substring match — pass the bare term (filter[title][like]=redesign). Do not add % wildcards; they are not needed.

or[group]

object

OR condition groups. Filters within a group are ANDed; groups are ORed.

Syntax: or[group_key][<attribute>]=value or or[group_key][<attribute>][operator]=value

Examples:

Simple OR: or[1][state]=draft&or[2][state]=pending
Complex: or[1][state]=draft&or[1][budget][gte]=50000&or[2][state]=closed
With custom fields: or[1][cf][priority]=high&or[2][state]=pending

Group keys can be any string (1, 2, a, b, etc.) - they just need to be unique.

sort[<attribute>]

object

Sort results by attribute. Direction defaults to ascending.

Syntax: sort[<attribute>]= (ascending) or sort[<attribute>]=desc (descending)

Sortable attributes: created_at, eoi_id, id, proposal, rejected_at, shortlisted_at, supplier_id, updated_at

Examples:

Ascending: sort[created_at]= or sort[created_at]=asc
Descending: sort[created_at]=desc

Response

List of eoi_responses

eoi_responses

object[]

Show child attributes

Authentication

Welcome

Bids

Eois

Eoi Responses

Invoices

Milestones

Offers

Projects

Supplier Lists

Suppliers

Variation Orders

Users

Skill Taxonomies

Tax Types

Bank Accounts

Raw Scorecard Entries

Reviews

Supplier Users

Orgs

Purchase Orders

Notes

Tasks

List Eoi Responses

Filtering

Basic Examples

Available Attributes

OR Conditions

Sorting

Authorizations

Query Parameters

Response