Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation retrieves a list of cards associated with a specified account. It is useful in scenarios where you need to fetch card details for an account, such as displaying card information in dashboards, processing card-related transactions, or managing card statuses programmatically.

For example, you might use this node to:

  • Get all active cards for a user’s account.
  • Filter cards by status or user ID.
  • Paginate through large sets of cards by skipping and taking a specific number of records.

Properties

Name Meaning
Account Id Identifier of the account whose cards you want to retrieve.
Filter JSON-stringified and URL-encoded filter expression object that conforms to a card filter schema. Allows filtering cards by properties like userId and status.
Skip Number of card objects to skip from the beginning of the result set (used for pagination).
Take Maximum number of card objects to return (used for pagination).

Output

The output contains a JSON array of card objects matching the query parameters. Each card object includes details such as card identifiers, user associations, status, and other relevant card metadata depending on the API response.

If the node supports binary data output (not indicated here), it would typically represent card images or attachments, but this operation focuses on JSON data retrieval.

Dependencies

  • Requires an API key credential configured in n8n to authenticate requests against the external service providing card data.
  • The base URL for the API must be set in the credentials configuration.
  • The node uses HTTP GET requests with query parameters for filtering, skipping, and taking results.

Troubleshooting

  • Empty results: Ensure the Account Id is correct and that the filter criteria are valid and match existing cards.
  • Invalid filter JSON: The $filter property must be a properly JSON-stringified and URL-encoded object conforming to the expected schema. Malformed JSON will cause request failures.
  • Pagination issues: Setting Skip or Take incorrectly (e.g., negative numbers) may lead to errors or unexpected results.
  • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions to access card data.
  • API connectivity: Check network connectivity and the correctness of the base URL in credentials if requests fail.

Links and References

  • Refer to the external API documentation for detailed schema of card objects and filter expressions.
  • n8n documentation on how to configure API credentials and use query parameters in nodes.

Discussion