Get a Offer

Get a Offer

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

import requests

url = "https://api.zivio.net/api/v4/offers/{id}"

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/offers/{id}', 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/offers/{id}",
  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/offers/{id}"

	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/offers/{id}")

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

{
  "id": 101,
  "version": 101,
  "status": "accepted",
  "rate": {
    "cents": 150000,
    "currency": "GBP"
  },
  "budget": {
    "cents": 150000,
    "currency": "GBP"
  },
  "additional_terms": "Example additional_terms",
  "created_by": {
    "id": 101,
    "first_name": "Demo",
    "last_name": "User",
    "email": "user1@example.com",
    "org_id": 501,
    "org_name": "Acme Corporation"
  },
  "auto_close": true,
  "supplier_contract_template": null,
  "client_contract_template": null,
  "skip_acceptance": true,
  "submitted_at": "2024-01-16T10:30:00+00:00",
  "start_date": "2024-03-08",
  "due_on": "2024-01-16",
  "expires_at": "2024-01-16T10:30:00+00:00",
  "accepted_at": "2024-01-16T10:30:00+00:00",
  "approved_at": "2024-01-16T10:30:00+00:00",
  "approved_by": {
    "id": 101,
    "first_name": "Demo",
    "last_name": "User",
    "email": "user1@example.com",
    "org_id": 501,
    "org_name": "Acme Corporation"
  },
  "approver_declined_reason": "Example approver_declined_reason",
  "declined_at": "2024-01-16T10:30:00+00:00",
  "declined_reason": "Example declined_reason",
  "reject_reason": "Example reject_reason",
  "bid": {
    "id": 101,
    "rate": {
      "cents": 150000,
      "currency": "GBP"
    },
    "version": 101,
    "proposal": "Example proposal",
    "supplier": null
  },
  "milestone_proposals": [
    {
      "id": 101,
      "client_details": "Example client_details",
      "client_due_on": "2024-01-16",
      "client_hours": 101,
      "client_rate": {
        "cents": 150000,
        "currency": "GBP"
      },
      "client_start_date": "2024-01-16",
      "client_suggested": false,
      "client_title": "Example client_title",
      "tiered_markup_fee": {
        "cents": 150000,
        "currency": "GBP"
      },
      "custom_fields": {
        "department": "Engineering",
        "priority": "high",
        "cost_code": "CC-001"
      }
    },
    {
      "id": 102,
      "client_details": "Example client_details",
      "client_due_on": "2024-01-17",
      "client_hours": 102,
      "client_rate": {
        "cents": 300000,
        "currency": "GBP"
      },
      "client_start_date": "2024-01-17",
      "client_suggested": false,
      "client_title": "Example client_title",
      "tiered_markup_fee": {
        "cents": 300000,
        "currency": "GBP"
      },
      "custom_fields": {
        "department": "Engineering",
        "priority": "high",
        "cost_code": "CC-001"
      }
    }
  ],
  "line_item_proposals": [
    {
      "id": 101,
      "name": "Acme Corporation",
      "manufacturer_name": "Example manufacturer_name",
      "manufacturer_part_number": "Example manufacturer_part_number",
      "quantity": "1500.00",
      "price": {
        "cents": 150000,
        "currency": "GBP"
      },
      "item_type": "service",
      "uom": null,
      "item_id": 501,
      "required": true,
      "project_line_item_id": 501
    },
    {
      "id": 102,
      "name": "Global Services Ltd",
      "manufacturer_name": "Example manufacturer_name",
      "manufacturer_part_number": "Example manufacturer_part_number",
      "quantity": "1500.00",
      "price": {
        "cents": 300000,
        "currency": "GBP"
      },
      "item_type": "item",
      "uom": null,
      "item_id": 502,
      "required": true,
      "project_line_item_id": 502
    }
  ],
  "admin_custom_fields": null,
  "custom_fields": {
    "department": "Engineering",
    "priority": "high",
    "cost_code": "CC-001"
  },
  "created_at": "2024-01-16T10:30:00+00:00",
  "updated_at": "2024-01-16T10:30:00+00:00",
  "project": {
    "id": 101,
    "title": "Website Redesign Project",
    "description": "Complete redesign of corporate website with modern UX"
  }
}

GET

offers

{id}

Get a Offer

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

import requests

url = "https://api.zivio.net/api/v4/offers/{id}"

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/offers/{id}', 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/offers/{id}",
  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/offers/{id}"

	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/offers/{id}")

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

{
  "id": 101,
  "version": 101,
  "status": "accepted",
  "rate": {
    "cents": 150000,
    "currency": "GBP"
  },
  "budget": {
    "cents": 150000,
    "currency": "GBP"
  },
  "additional_terms": "Example additional_terms",
  "created_by": {
    "id": 101,
    "first_name": "Demo",
    "last_name": "User",
    "email": "user1@example.com",
    "org_id": 501,
    "org_name": "Acme Corporation"
  },
  "auto_close": true,
  "supplier_contract_template": null,
  "client_contract_template": null,
  "skip_acceptance": true,
  "submitted_at": "2024-01-16T10:30:00+00:00",
  "start_date": "2024-03-08",
  "due_on": "2024-01-16",
  "expires_at": "2024-01-16T10:30:00+00:00",
  "accepted_at": "2024-01-16T10:30:00+00:00",
  "approved_at": "2024-01-16T10:30:00+00:00",
  "approved_by": {
    "id": 101,
    "first_name": "Demo",
    "last_name": "User",
    "email": "user1@example.com",
    "org_id": 501,
    "org_name": "Acme Corporation"
  },
  "approver_declined_reason": "Example approver_declined_reason",
  "declined_at": "2024-01-16T10:30:00+00:00",
  "declined_reason": "Example declined_reason",
  "reject_reason": "Example reject_reason",
  "bid": {
    "id": 101,
    "rate": {
      "cents": 150000,
      "currency": "GBP"
    },
    "version": 101,
    "proposal": "Example proposal",
    "supplier": null
  },
  "milestone_proposals": [
    {
      "id": 101,
      "client_details": "Example client_details",
      "client_due_on": "2024-01-16",
      "client_hours": 101,
      "client_rate": {
        "cents": 150000,
        "currency": "GBP"
      },
      "client_start_date": "2024-01-16",
      "client_suggested": false,
      "client_title": "Example client_title",
      "tiered_markup_fee": {
        "cents": 150000,
        "currency": "GBP"
      },
      "custom_fields": {
        "department": "Engineering",
        "priority": "high",
        "cost_code": "CC-001"
      }
    },
    {
      "id": 102,
      "client_details": "Example client_details",
      "client_due_on": "2024-01-17",
      "client_hours": 102,
      "client_rate": {
        "cents": 300000,
        "currency": "GBP"
      },
      "client_start_date": "2024-01-17",
      "client_suggested": false,
      "client_title": "Example client_title",
      "tiered_markup_fee": {
        "cents": 300000,
        "currency": "GBP"
      },
      "custom_fields": {
        "department": "Engineering",
        "priority": "high",
        "cost_code": "CC-001"
      }
    }
  ],
  "line_item_proposals": [
    {
      "id": 101,
      "name": "Acme Corporation",
      "manufacturer_name": "Example manufacturer_name",
      "manufacturer_part_number": "Example manufacturer_part_number",
      "quantity": "1500.00",
      "price": {
        "cents": 150000,
        "currency": "GBP"
      },
      "item_type": "service",
      "uom": null,
      "item_id": 501,
      "required": true,
      "project_line_item_id": 501
    },
    {
      "id": 102,
      "name": "Global Services Ltd",
      "manufacturer_name": "Example manufacturer_name",
      "manufacturer_part_number": "Example manufacturer_part_number",
      "quantity": "1500.00",
      "price": {
        "cents": 300000,
        "currency": "GBP"
      },
      "item_type": "item",
      "uom": null,
      "item_id": 502,
      "required": true,
      "project_line_item_id": 502
    }
  ],
  "admin_custom_fields": null,
  "custom_fields": {
    "department": "Engineering",
    "priority": "high",
    "cost_code": "CC-001"
  },
  "created_at": "2024-01-16T10:30:00+00:00",
  "updated_at": "2024-01-16T10:30:00+00:00",
  "project": {
    "id": 101,
    "title": "Website Redesign Project",
    "description": "Complete redesign of corporate website with modern UX"
  }
}

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.

Path Parameters

integer

required

Offer ID

Response

Offer details

integer

version

integer

status

enum<string>

Available options:

pending,

accepted,

declined,

withdrawn,

expired,

onboarding,

generating,

signature_error,

sending,

cancelled,

draft,

submitted

Example:

"pending"

rate

object

Show child attributes

budget

object

Show child attributes

additional_terms

string

created_by

object | null

Show child attributes

auto_close

boolean

Example:

true

supplier_contract_template

string

client_contract_template

string

skip_acceptance

boolean

Example:

true

submitted_at

string

start_date

string

due_on

string

expires_at

string

accepted_at

string

approved_at

string

approved_by

object | null

Show child attributes

approver_declined_reason

string

declined_at

string

declined_reason

string

reject_reason

string

bid

object | null

Show child attributes

milestone_proposals

object[]

Show child attributes

line_item_proposals

object[]

Show child attributes

admin_custom_fields

object

Key-value pairs of custom field data

Show child attributes

custom_fields

object

Key-value pairs of custom field data

Show child attributes

created_at

string

updated_at

string

project

object | null

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

Authorizations

Path Parameters

Response