GET/vector_stores

List vector stores

Lists vector stores, which are collections of processed files that you can use with the file_search tool. Use the cursor parameters to move forward or backward through the results, and set order to control sorting by creation time.

4 parameters
limitintegeroptional
Maximum number of vector stores to return, from 1 to 100. Defaults to 20 when omitted.
Default:20
orderstringoptional
Sort order by creation time: `asc` or `desc`. Defaults to `desc` when omitted.
Allowed:ascdescDefault:desc
afterstringoptional
Cursor identifying the last object on the previous page; use it to fetch the next page.
beforestringoptional
Cursor identifying the first object on the current page; use it to fetch the previous page.

3 status codes
200Returns a page of vector store objects with cursor IDs and a `has_more` flag indicating whether more results are available.
objectstringrequired
dataarray<VectorStore>required
first_idstringrequired
last_idstringrequired
has_morebooleanrequired
429Returned when the request rate limit is exceeded.
errorobjectrequired
503Returned when the vector store list is temporarily unavailable; retry the request.
errorobjectrequired

Error handling

A 429 is returned when the request rate limit is exceeded, and a 503 is returned when the vector store list is temporarily unavailable. limit must be between 1 and 100, and order must be asc or desc.