Retrieve an invoice's custom object instance

GET

invoices

{invoice_id}

custom_objects

{custom_object_id}

instances

{instance_id}

cURL

curl -X GET "$EXSITED_BASE_URL/api/v4/invoices/INV-0001/custom_objects/co_5d2a8f1c3b7e4a9d8c6b1e2f3a4d5c6b/instances/coi_9f3b6c1d2e8a4b7c9d5e1f2a3b4c6d7e" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

from exsited import build_client

client = build_client()

response = client.invoices.get_invoice_custom_object_instance(
    "INV-0001",
    "co_5d2a8f1c3b7e4a9d8c6b1e2f3a4d5c6b",
    "coi_9f3b6c1d2e8a4b7c9d5e1f2a3b4c6d7e",
)
print(response.data)

import {buildClient} from 'exsited';

const client = await buildClient();

const response = await client.invoices.getInvoiceCustomObjectInstance(
    'INV-0001',
    'co_5d2a8f1c3b7e4a9d8c6b1e2f3a4d5c6b',
    'coi_9f3b6c1d2e8a4b7c9d5e1f2a3b4c6d7e',
);
console.log(response.data);

use Exsited\Client\ClientRegistry;

$client = ClientRegistry::buildClient();

$response = $client->invoices->getInvoiceCustomObjectInstance(
    'INV-0001',
    'co_5d2a8f1c3b7e4a9d8c6b1e2f3a4d5c6b',
    'coi_9f3b6c1d2e8a4b7c9d5e1f2a3b4c6d7e',
);
print_r($response->data);

import com.exsited.Dto;
import com.exsited.client.ApiResponse;
import com.exsited.client.ClientRegistry;
import com.exsited.client.ExsitedClient;

ExsitedClient client = ClientRegistry.buildClient();

ApiResponse<Dto> response = client.invoices().getInvoiceCustomObjectInstance(
        "INV-0001",
        "co_5d2a8f1c3b7e4a9d8c6b1e2f3a4d5c6b",
        "coi_9f3b6c1d2e8a4b7c9d5e1f2a3b4c6d7e");
System.out.println(response.getMap());

using Exsited.Client;

await using var client = ExsitedClient.BuildClient();

var response = await client.Invoices.GetInvoiceCustomObjectInstanceAsync(
    "INV-0001",
    "co_5d2a8f1c3b7e4a9d8c6b1e2f3a4d5c6b",
    "coi_9f3b6c1d2e8a4b7c9d5e1f2a3b4c6d7e");

Console.WriteLine(response.Json);

import 'package:exsited/exsited.dart';

final client = buildClient();

final response = await client.invoices.getInvoiceCustomObjectInstance(
  'INV-0001',
  'co_5d2a8f1c3b7e4a9d8c6b1e2f3a4d5c6b',
  'coi_9f3b6c1d2e8a4b7c9d5e1f2a3b4c6d7e',
);
print(response.map);

import (
	"context"
	"fmt"
	"log"

	exsited "github.com/exsited/exsited-sdk-go/v4"
)

client, err := exsited.BuildClient(nil)
if err != nil {
	log.Fatal(err)
}
defer client.Close()

response, err := client.Invoices().GetInvoiceCustomObjectInstance(context.Background(), "INV-0001", "co_5d2a8f1c3b7e4a9d8c6b1e2f3a4d5c6b", "coi_9f3b6c1d2e8a4b7c9d5e1f2a3b4c6d7e", nil)
if err != nil {
	log.Fatal(err)
}
fmt.Println(response.Map)

Fetches a single instance of a custom object that belongs to this invoice.

The SDK samples get their client from credentials your app registers once when it starts, as shown in Authentication. To try the call here, click Try it, set host to your Exsited API host name and paste an access token from Get an access token.

Authorizations

Authorization

string

header

required

An access token from POST /api/v4/oauth2/token. The SDKs get and renew it for you.

Path Parameters

invoice_id

string

required

The invoice's id, such as INV-0001. Not its uuid.

custom_object_id

string

required

The custom object's id, which starts with co_.

instance_id

string

required

The custom object instance's id, which starts with coi_.

Response

200

The custom object instance.

Guides

API reference

Retrieve an invoice's custom object instance

Authorizations

Path Parameters

Response