Shopware icon

Shopware

Shopware

Actions778

Country State → Get Country State List

AI-generated

Overview

This node operation retrieves a list of country states from the Shopware API. It supports pagination and filtering through query parameters, allowing users to specify the maximum number of results per page, the page number to retrieve, and a custom query in SwagQL JSON format. This operation is useful for scenarios where you need to fetch and process geographical subdivisions of countries, such as for address validation, shipping calculations, or regional reporting.

Use Case Examples

  1. Fetch the first 50 country states to populate a dropdown in a form.
  2. Retrieve a specific page of country states with a custom filter query to display in a report.

Properties

Name Meaning
Limit Maximum number of country state resources to be returned in a single page.
Page The page number of the results to be returned.
Query Encoded SwagQL query in JSON format to filter or customize the returned country state list.
Request Options Additional request settings such as batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • countryStates - List of country state objects returned from the API.

Dependencies

  • Shopware API credentials (API key or token)

Troubleshooting

  • Ensure the Shopware API credentials are correctly configured and have the necessary permissions to access country state data.
  • Check network connectivity and proxy settings if requests fail or time out.
  • Verify the SwagQL query syntax if using the Query parameter to filter results, as invalid queries may cause errors.

Discussion