Get product tags
Use this endpoint to retrieve a list of all available product tags. Use tags to categorize and filter products when building your catalog UI.
Filtering options:
titlequery parameter - search string to filter tags by name. Minimum 3 characters when provided. Omit to return all tags.companyIdquery parameter - Company ID (when not inferable from the calling key)Request-Sourceheader - source of the request
Pagination:
skipquery parameter - number of records to skip (default0)limitquery parameter - max records per page (1-100, default100)
Permissions
- Requires:
products:read
Authorizations
Company Level Authentication
Company level authentication provides access to all resources under your company, including accounts, campaigns, gifts, and recipients.
Getting Your API Key
- Create an API Key: Use the
POST /v2/authentication/apiKeysendpoint to generate a new API key - Set Expiration: Choose from 30, 60, 90, or 180 days (default: 90 days)
- Optional mTLS: Enable mutual TLS for enhanced security
- Name Your Key: Provide a descriptive name for easy identification
Using Your API Key
Include your API key in the X-Api-Key header for every request:
API Key Management
- Maximum Keys: Up to 3 active API keys per company
- Rotation: Delete old keys before creating new ones when at the limit
- Security: Keys are hashed and cannot be retrieved after creation
Enhanced Security (mTLS)
For production environments, enable mutual TLS authentication:
- Set
enforceMtls: truewhen creating the API key - Contact support to obtain your client certificates
- Use the mTLS endpoint:
https://mtls-api.snappy.com/public-api
Headers
Source of the request
api_native, api_zapier, api_salesforce, api_ftp, api_make "api_native"
Query Parameters
Company ID
^[A-Za-z0-9]{8,}$"12345678"
Search string to filter tags by name (minimum 3 characters)
3"tech"
Number of records to skip for pagination (use with limit for paging through results)
x >= 00
Maximum number of records to return per page
1 <= x <= 10010
Response
Successful response
Response containing product tags.
The fetched product tags.