Serial Numbers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Serial numbers help you track individual units of inventory items by assigning a unique identifier to each unit.

Download Serial Numbers OpenAPI Document

End Points

GET

/items/serialnumbers

GET

/items/serialnumbers/{serial_number_id}

Attribute

serialnumber_id

string

Unique identifier of the serial number.

serialnumber

string

Serial number assigned to the unit.

code

string

Code of the serial number. Same value as serialnumber.

status

string

Status of the serial number. Allowed values active and inactive.

is_transacted_out

boolean

Indicates whether the serial number has been transacted out and is no longer available in stock.

item_id

string

Unique identifier of the item the serial number belongs to.

price

float

Price of the item associated with the serial number.

custom_fields

array

Custom fields configured for the serial number.

Show Sub-Attributes

custom_field_id

string

Unique identifier of the custom field.

label

string

Label of the custom field.

value

string

Value of the custom field.

{
    "serialnumber_id": "6780203000000176190",
    "serialnumber": "SN-LAP-001",
    "code": "SN-LAP-001",
    "status": "active",
    "is_transacted_out": false,
    "item_id": "6780203000000167467",
    "price": 1500,
    "custom_fields": [
        {
            "custom_field_id": "6780203000000176175",
            "label": "Warranty Period",
            "value": "2 Years"
        }
    ]
}

List all serial numbers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

List all serial numbers available for a given item.
OAuth Scope : ZohoInventory.items.READ

Query Parameters

organization_id

string

(Required)

ID of the organization

item_id

string

(Required)

Unique identifier of the item to fetch serial numbers for.

show_transacted_out

boolean

Include serial numbers that have already been transacted out. Allowed values true and false.

warehouse_id

string

Filter serial numbers by warehouse ID.

location_id

string

Filter serial numbers by location ID.

batch_id

string

Filter serial numbers by batch ID. Use for items with both serial and batch tracking enabled.

item_name

string

Search serial numbers by item name.

sort_column

string

Column to sort the response by. Allowed value serialnumber.

sort_order

string

Order of sorting. Allowed values A for ascending and D for descending.

page

integer

Page number to be fetched. Default value is 1.

per_page

integer

Number of records to be fetched per page. Default value is 200.

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/inventory/v1/items/serialnumbers?organization_id=10234695&item_id=6780203000000167467"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/inventory/v1/items/serialnumbers?organization_id=10234695&item_id=6780203000000167467")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/inventory/v1/items/serialnumbers?organization_id=10234695&item_id=6780203000000167467', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/inventory/v1/items/serialnumbers?organization_id=10234695&item_id=6780203000000167467", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/inventory/v1/items/serialnumbers?organization_id=10234695&item_id=6780203000000167467",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url 'https://www.zohoapis.com/inventory/v1/items/serialnumbers?organization_id=10234695&item_id=6780203000000167467' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "serial_numbers": [
        {
            "serialnumber_id": "6780203000000176190",
            "serialnumber": "SN-LAP-001",
            "status": "active",
            "is_transacted_out": false,
            "batch_id": "6780203000000176162",
            "batch_number": "BATCH-001",
            "batch_custom_fields": [
                {
                    "custom_field_id": "6780203000000176175",
                    "label": "Warranty Period",
                    "value": "2 Years"
                }
            ],
            "custom_fields": [
                {
                    "custom_field_id": "6780203000000176175",
                    "label": "Warranty Period",
                    "value": "2 Years"
                }
            ]
        },
        {...},
        {...}
    ]
}

Retrieve a serial number AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Fetch the details of a specific serial number.
OAuth Scope : ZohoInventory.items.READ

Path Parameters

serial_number_id

string

(Required)

Unique identifier of the serial number.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/inventory/v1/items/serialnumbers/6780203000000176190?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/inventory/v1/items/serialnumbers/6780203000000176190?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/inventory/v1/items/serialnumbers/6780203000000176190?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/inventory/v1/items/serialnumbers/6780203000000176190?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/inventory/v1/items/serialnumbers/6780203000000176190?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url 'https://www.zohoapis.com/inventory/v1/items/serialnumbers/6780203000000176190?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "serial_number": {
        "serialnumber_id": "6780203000000176190",
        "serialnumber": "SN-LAP-001",
        "code": "SN-LAP-001",
        "status": "active",
        "is_transacted_out": false,
        "item_id": "6780203000000167467",
        "price": 1500,
        "custom_fields": [
            {
                "custom_field_id": "6780203000000176175",
                "label": "Warranty Period",
                "value": "2 Years"
            }
        ]
    }
}

Serial Numbers AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Attribute

List all serial numbers AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Query Parameters

Retrieve a serial number AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Query Parameters

Serial Numbers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

List all serial numbers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Retrieve a serial number AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab