Endpoints

Approved-parts lists

Your approved-parts lists

Enumerate the approved-parts lists you can search within — your own AVLs (approved vendor lists) plus the curated lists Zenode publishes (e.g. Space Grade, Military Grade). Each list has an opaque list_id (a lst_… handle) that you pass as filters.list_filter on catalog search, its facets, and AI discovery to scope results to that list. Free to call.

parts:read

Lists are created and managed in the Zenode app, not through the API — this endpoint is a read-only enumeration so an integration can discover the list_ids it's allowed to search within.

List approved-parts lists

GEThttps://api.zenode.ai/v1/listsFree

Response

JSON

1{
2  "lists": [
3    {
4      "list_id": "lst_9f2a3c...",
5      "name": "Automotive AVL",
6      "kind": "user",
7      "member_count": 128
8    },
9    {
10      "list_id": "lst_space",
11      "name": "Space Grade",
12      "kind": "curated",
13      "member_count": 86000,
14      "slug": "space-grade",
15      "description": "High-reliability, space-qualified parts"
16    }
17  ],
18  "notice": null,
19  "request_id": "req_5b71..."
20}

Parameter	Type	Required	Description
`lists`	ApprovedList[]	Required	Your own lists first (most recently updated), then published curated lists
`notice`	string \| null	Required	Guidance when you have no personal lists yet, or none are available; null otherwise
`request_id`	string	Required	For support / tracing

Each entry in lists is an ApprovedList:

Parameter	Type	Required	Description
`list_id`	string	Required	Opaque list handle (lst_…). Pass this as filters.list_filter to scope a search — copy it, don't construct one
`name`	string	Required	Human-readable list name
`kind`	string	Required	user (one of your AVLs) or curated (Zenode-published, read-only)
`member_count`	int	Required	Number of parts in the list (cached; may lag the engine slightly)
`slug`	string \| null	Optional	Stable editorial key for curated lists (e.g. space-grade); absent on your own lists
`description`	string \| null	Optional	Short description; curated lists only

BASH

1curl https://api.zenode.ai/v1/lists \\
2  -H "Authorization: Bearer <YOUR API KEY HERE>"

Copy a list_id from this response into filters.list_filter to scope a search to that list. Pass a single lst_… id, or an array of ids for the union of several lists.

Try it

Try itGET

API key (Bearer token)

API base URL

Request

cURL

curl -X GET "https://api.zenode.ai/v1/lists" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Part Catalog search — scope a search with filters.list_filter
PartFilters — the list_filter field
AI discovery — let the AI search within a list

PreviousUsage

List approved-parts lists

Response

Try it

Next