Your AI team, working in Zip

Zip is an AI procurement orchestration platform for managing purchasing, approvals, suppliers, contracts, invoices, and spend from intake to payment.

Start your company

What your team can do in Zip

161 tools to work with, connected with an API key.

Add invoice line items

Add multiple line items to an existing bill invoice by invoice ID.

Add vendor credit line items

Add multiple line items to an existing Zip vendor credit; this endpoint must be enabled for the organization.

Archive an item receipt

Archive an item receipt. Archives a submitted receipt or return, the same way archiving works in Zip. An archived receipt no longer counts toward three-way match, and allocation to matched bills runs again without it. Fails if the receipt backs a bill that has already been paid. This is a status change, not a delete. On success, the archived item receipt is returned.

Create a comment

Create a comment or reply to an existing comment on Zip's request details page (RDP).

Create a delegation

Create a delegation. Create an out-of-office delegation. The delegator's approval responsibilities will be transferred to the delegate for the specified date range. Only one active (unexpired) delegation is allowed per delegator. Circular delegations (A delegates to B who delegates back to A) are not allowed.

Create a department

Create a department in Zip with its name, display name, active status, and visibility settings.

Create a lookup option

Create a lookup option in Zip.

Create a product

Create a product in Zip with its required name and optional product metadata.

Create a risk assessment

Record a completed or canceled risk assessment performed outside Zip.

Create a role

Create an organization role in Zip.

Create a saving line item

Add a saving line item to an existing Zip purchase request.

Create a subsidiary

Create an organization subsidiary in Zip.

Create a tax code

Create a tax code in Zip with its name, type, active status, and accounting fields.

Create a user

Create a user in Zip; this API operation requires a Zip Premier subscription.

Create a vendor credit

Create a vendor credit. Creates a new uncoded vendor credit with the specified details and initializes its approval workflow. On success, the created vendor credit is returned. This endpoint must be enabled for your organization.

Create a vendor item

Create a vendor item in Zip from the supplied item fields.

Create a vendor item group

Create a vendor item group in Zip from the supplied group fields.

Create a vendor site

Create a vendor site in Zip with the supplied site attributes.

Create address

Create a vendor or company address in Zip from structured address fields.

Create an expense category

Create an expense category in Zip with its accounting and active-status fields.

Create an invoice

Create an invoice. Creates a new draft bill invoice with the specified details and initializes its approval workflow. The invoice can optionally be matched to one or more purchase orders by providing either purchase_order_ids or purchase_order_numbers. On success, the created invoice is returned.

Create an invoice from e-invoice XML

Create an invoice from an e-invoice payload. Send XML with `application/xml` or `text/xml`, or send the documented JSON form with `application/json` when supplying an optional PDF. Set `provider` only for invoices processed through Zip's billable provider agreement, and set `jurisdiction=FR` only with explicit France routing context; neither value is inferred from the payload.

Create an item receipt

Create an item receipt. Creates a receipt or a return against one purchase order, already submitted. Each line must name a line on that purchase order that requires receiving, at most once, with quantity for a quantity line or total_amount for an amount line. Allocation to matched bills runs after the receipt is saved, as it does for receipts submitted in Zip. Purchase orders that receive in an ERP are rejected. On success, the created item receipt is returned.

Create GL code

Create a GL account in Zip.

Create item account

Create an item-account lookup record in Zip from the supplied account fields.

Create location

Create a company location in Zip with a name and status.

Create look up type

Create a lookup type in Zip.

Create main queue

Create a main approval queue in Zip.

Create or update an option filter rule

Create or update a Zip option filter rule by client-provided rule ID. Option values are matched by their raw, untranslated names.

Create or update option filter rules in a batch

Atomically create or update 1 to 100 Zip option filter rules. The entire batch is rejected if any item fails validation.

Create subqueue

Create subqueue. Creates a subqueue on a main queue by ID.

Create vendor contact

Create a contact for a vendor in Zip.

Deactivates user by ID

Destructive, high-impact operation that deactivates a Zip user's access and may require reassignment of their work; it does not delete the user record. Verify the user ID before calling.

Delete a comment

Delete a Zip comment by its GUID on behalf of the specified user.

Delete a delegation

Delete a delegation. Soft-delete a delegation by setting its end date to yesterday. This is the same operation as the "End Now" and "Delete" actions in the Zip UI. The delegation's status will become EXPIRED and any currently delegated approvals will be reassigned back to the original delegator.

Delete a saving line item

Delete the purchase-request saving line item identified by `saving_line_item_id`.

Delete an option filter rule by rule ID

Delete a Zip option filter rule by its client-provided rule ID.

Delete department by ID

Delete a single department from Zip by ID.

Delete expense category by ID

Delete an expense category from Zip so it can no longer be used for expense classification.

Delete location by ID

Delete a company location from Zip by ID.

Delete lookup by ID

Delete a Zip lookup type by ID.

Delete lookup option by ID

Delete a Zip lookup option by ID.

Delete queue by Id

Delete a main queue or subqueue from Zip by queue ID.

Delete role by ID

Delete a single organization role from Zip by ID.

Delete subsidiary by ID

Delete a single organization subsidiary from Zip by ID.

Delete tax code by ID

Delete a tax code from Zip by ID so it is no longer available for tax classification.

Delete vendor by ID

Delete a single vendor from Zip by vendor ID.

Get a change order by IDReads only

Get a change order by ID. Returns the changed header fields and created, deleted, and updated purchase order lines for a change order.

Get a delegation by IDReads only

Retrieve one out-of-office approval delegation from Zip by ID.

Get a purchase order by IDReads only

Retrieve one Zip purchase order when its `purchase_order_id` is already known.

Get a request' questionnaire responsesReads only

Retrieve questionnaire responses for a Zip purchase request by request ID.

Get a single purchase requestReads only

Retrieve a single Zip purchase request by request ID.

Get a tax codeReads only

Retrieve one Zip tax code and its tax-classification settings by ID.

Get agent session by IDReads only

Get metadata for an agent session when Superagents is enabled.

Get agreement by IDReads only

Retrieve one Zip agreement when its `agreement_id` is already known.

Get all available purchase categoriesReads only

List all purchase categories defined in the company's Zip settings.

Get amortization schedule by IDReads only

Retrieve one Zip amortization schedule when its `amortization_schedule_id` is already known.

Get an item receipt by IDReads only

Retrieve one Zip item receipt when its `item_receipt_id` is already known.

Get an option filter rule by rule IDReads only

Retrieve a Zip option filter rule by its client-provided rule ID.

Get department by IDReads only

Retrieve one Zip department and its organization settings by ID.

Get document by IDReads only

Download a Zip document as a PDF file reference.

Get expense category by IDReads only

Retrieve one Zip expense category and its accounting settings by ID.

Get GL code by IDReads only

Retrieve a GL account lookup from Zip by ID.

Get invoice by IDReads only

Get invoice by ID. Retrieves a single bill invoice by its ID, including its custom attributes and line items with their attributes. Use the line_items_count_only parameter to return just the line item count instead of the full line items array for better performance.

Get invoice cXMLReads only

Get invoice cXML. Retrieves the raw cXML payload for a punchout invoice. Returns the most recent cXML message associated with the invoice.

Get item account by IDReads only

Retrieve one Zip item-account lookup record when its `item_account_id` is already known.

Get line itemsReads only

Get line items. Query an invoice's line items with filters and pagination. Results are ordered by created_at in ascending order (oldest first).

Get lookup by IDReads only

Retrieve a Zip lookup type by ID.

Get lookup option by IDReads only

Retrieve a Zip lookup option by ID.

Get payment method by IDReads only

Retrieve a Zip payment method by ID, optionally including sensitive or deleted data.

Get payment terms by IDReads only

Retrieve one Zip payment-terms record when its `payment_terms_id` is already known.

Get payout by IDReads only

Retrieve a single Zip payout by payout ID.

Get products by IDsReads only

Retrieve multiple Zip product records in one call from a list of product IDs.

Get queue by IDReads only

Retrieve a main queue or subqueue from Zip by queue ID.

Get risk assessment by IDReads only

Retrieve one Zip risk assessment by ID.

Get risk assessment fields schemaReads only

List the active custom fields on Zip risk assessments.

Get role by IDReads only

Retrieve one organization role from Zip by ID.

Get saving line item by IDReads only

Retrieve one purchase-request saving line item when its `saving_line_item_id` is already known.

Get subsidiary by IDReads only

Retrieve one organization subsidiary from Zip by ID.

Get user by IDReads only

Retrieve one Zip user and their organization assignments by ID.

Get user group by IDReads only

Retrieve one Zip user group by ID.

Get vendor by IDReads only

Retrieve a single Zip vendor by vendor ID, optionally including risk tiers, assessments, and findings when Risk Orchestration is enabled.

Get vendor credit by IDReads only

Retrieve a single Zip vendor credit by vendor-credit ID.

Get vendor item groups by IDsReads only

Retrieve multiple Zip vendor item groups by their IDs.

Get vendor items by IDsReads only

Retrieve multiple Zip vendor items by their IDs.

Get vendor rolesReads only

List one page of vendor roles configured for the authenticated organization. This beta feature requires vendor-role listing to be enabled; use returned role IDs when assigning or removing vendor owners.

Get vendor site by IDReads only

Retrieve a single Zip vendor site by site ID.

Get Workflow AttributesReads only

Get Workflow Attributes. Get a schema of configurable attributes given a Zip workflow ID.

Get WorkflowsReads only

Get Workflows. Fetch a list of request workflows configured for the company.

List agent sessionsReads only

List one page of agent sessions for a company with Superagents enabled.

List change ordersReads only

List change orders. Returns submitted change orders with their changed header fields and created, deleted, and updated purchase order lines. A change order is included even when the selected field groups contain no changes. Results are returned in pages of up to 50.

List currenciesReads only

List currencies supported by the connected Zip company.

List engagementsReads only

List one page of the company's active and inactive Zip engagements.

List messages in an agent sessionReads only

List messages in an agent session in chronological order.

List risk assessmentsReads only

List the company's risk assessments, optionally filtered by vendor.

List risk levelsReads only

List the company's risk tiers from highest to lowest risk.

List vendor payment methodsReads only

Retrieve a vendor's payment methods, optionally including sensitive or deleted records and filtering by status.

Search agreementsReads only

Search one page of Zip agreements using vendor, subsidiary, or department filters.

Search amortization schedulesReads only

Search one page of Zip amortization schedules by active status or name.

Search approvalsReads only

Search one page of approvals by request, approval status, node type, date range, or request type; optionally include neighboring approval nodes.

Search audit trail logsReads only

Search one page of Zip audit trail events; export requires Zip Premier.

Search catalogReads only

Search for vendor items and vendor item groups in the Zip catalog.

Search commentsReads only

Search comments belonging to a purchase requisition, optionally filtered by request GUID.

Search delegationsReads only

Search delegations. Search delegations with optional filters. Returns delegations for the authenticated organization. Use delegator_email or delegate_email to find delegations for a specific user. Use is_active to filter current vs expired delegations.

Search departmentsReads only

Search departments. Multiple search filters can be provided.

Search expense categoriesReads only

Search Zip expense categories using documented filters.

Search GL codesReads only

Search GL accounts in Zip and return one page of results.

Search invoicesReads only

Search one page of invoices by creation, update, approval, amount, invoice number, status, vendor, or upload source; optionally return IDs or line-item counts only.

Search item accountsReads only

Search item accounts in Zip by name, active status, or external ID.

Search item receiptsReads only

Search one page of Zip item receipts by created time, updated time, or receipt status.

Search locationsReads only

Search Zip company locations by name or status and return one page of results.

Search look up typesReads only

Search Zip lookup types and return one page of results.

Search lookup optionsReads only

Search Zip lookup options and return one page of results.

Search payment termsReads only

Search payment terms in Zip and return one page of results.

Search purchase ordersReads only

Search one page of Zip purchase orders by PO or request number, status, requester, department, dates, open amount, or vendor.

Search requestsReads only

Search one page of Zip requests by request details, requester, department, vendor, status, type, priority, or date range, with optional sorting and custom attributes.

Search rolesReads only

Search Zip organization roles by name and return one page of results.

Search saving line items by field filtersReads only

Search one page of purchase-request saving line items. Filter by custom field GUID or by saving_line_item_type, recognition_frequency, recognition_start_date, or recognition_end_date.

Search subsidiariesReads only

Search subsidiaries. Multiple search filters can be provided.

Search tax codesReads only

Search Zip tax codes and return one page of results.

Search user groupsReads only

Search user groups. Multiple search filters can be provided.

Search usersReads only

Search users. Multiple search filters can be provided.

Search vendor creditsReads only

Search one page of Zip vendor credits by credit invoice number, with optional creation/update sorting.

Search vendorsReads only

Search one page of vendors by name, status, update time, subsidiary, or department; optionally include custom attributes and risk data.

Send a bill invoice for approval

Send a bill invoice for approval. Validates a draft bill invoice and submits it for approval. The invoice is validated for completeness, then transitioned into the approval workflow. On success, the updated invoice is returned with its new status.

Send a vendor credit for approval

Send a vendor credit for approval. Validates an uncoded vendor credit and submits it for approval. The credit is validated for completeness, then transitioned into the approval workflow (or logged as available when approvals are not configured). On success, the updated vendor credit is returned with its new status. This endpoint must be enabled for your organization.

Update a delegation

Update a delegation. Update an existing delegation. All fields are optional but at least one must be provided. Changing the delegate triggers a circular delegation check. Changing dates or timezone recalculates the start/end timestamps.

Update a location.

Update a Zip company location's name or status by ID.

Update a lookup option

Update a Zip lookup option by ID.

Update a request's status (reject or cancel).

Update a request's status (reject or cancel). Reject or cancel a request. The transition is terminal and closes the approval chain. Bills and payout groups have their own cancel flows and are not supported.

Update a saving line item

Partially update a Zip saving line item; omitted fields remain unchanged.

Update a single purchase request

Update the supplied fields on a single Zip purchase request by request ID.

Update a tax code

Partially update a Zip tax code's name, type, active status, or accounting fields by ID.

Update a vendor credit line item

Update a line item on a Zip vendor credit; this endpoint must be enabled, and coded credits allow only a limited field set.

Update an invoice's paid status.

High-impact, irreversible operation that marks a bill invoice paid and creates its payout. Verify the invoice ID and payment state before calling.

Update an item receipt

Update an item receipt. Edits a submitted receipt or return. Fields left out keep their values. line_items, when sent, replaces the receipt's lines under the same rules as create: a line already on the receipt is updated in place, a new PO line is added, and a line left out is removed. Allocation to matched bills runs again after the edit is saved. The receipt type, number and purchase order don't change. On success, the updated item receipt is returned.

Update department by ID

Update a Zip department's name, display name, active status, or visibility by ID.

Update expense category by ID

Update a Zip expense category's accounting or active-status fields by ID.

Update GL code by ID

Update a GL account in Zip by ID.

Update invoice header information

Update invoice header information. Updates header-level fields on a bill invoice such as vendor, subsidiary, currency, dates, amounts, description, and custom attributes. The invoice can also be matched to purchase orders by providing purchase_order_ids or purchase_order_numbers. On success, the updated invoice is returned.

Update invoice line item

Update the supplied fields on one invoice line item by invoice and line-item IDs.

Update lookup by ID

Update a Zip lookup type by ID.

Update payment method by ID

Update external identifiers or custom fields on a Zip payment method.

Update product by ID

Update a Zip product's name or metadata by product ID.

Update purchase order statuses

High-impact, irreversible bulk operation that cancels, closes, or soft-closes up to 50 purchase orders. Verify every purchase order ID and target status before calling.

Update queue by ID

Update queue by ID. Updates a main queue or a subqueue by ID.

Update role by ID

Destructive, high-impact operation that changes an organization role and can alter users' access. Verify the role ID and permission impact before calling.

Update subsidiary by ID

Update an organization subsidiary in Zip by ID.

Update the line items of a purchase request

Update the line items of a purchase request. Update the line items of a single purchase request, given the request ID.

Update user by ID

Update a single Zip user by ID; this API operation requires a Zip Premier subscription.

Update user group by ID

Update user group by ID. Update the description of a single user group by ID.

Update vendor by ID

Update the supplied fields on a single Zip vendor by vendor ID.

Update vendor credit header information

Update vendor credit header information. Updates header-level fields on a vendor credit such as vendor, subsidiary, currency, dates, amounts, description, and custom attributes. On success, the updated vendor credit is returned. This endpoint must be enabled for your organization. When the credit is already coded, only a limited set of header fields can be updated.

Update vendor item by ID

Update the supplied fields on a Zip vendor item by item ID.

Update vendor item group by ID

Update the supplied fields on a Zip vendor item group by group ID.

Update vendor site by ID

Update the supplied fields on a Zip vendor site by site ID.

Upload a document

Upload a document to Zip using multipart form data.

Upsert budget

Create or update a Zip budget using its period and dimensions.

Upsert budget actual

Create or update a Zip budget actual using its date and dimensions.

Upsert currencies

Add currencies to the connected Zip company's supported list; existing currencies not included in the request remain supported.

Upsert vendor keyed by external id

Upsert vendor keyed by external id. Create or update a vendor given an external ID.

More in Accounting

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or