HTTP GET

HTTP GET

Type: http-get  ·  Package: HTTP Activities v1.0.0  ·  Output: ZoanHttpResponse

Sends a GET request to read/query data from an API or web service. It is the most common request: obtain a record, list elements, download data. Does not send body; all the information goes in the URL (including query parameters like ?estado=activo).

How it works

Makes the request to url (with optional headers and authentication) and returns ZoanHttpResponse. If the response body is JSON, it is automatically converted to a dictionary/list. Remember: if the server responds with an error code, the activity fails — see error handling.

Required parameters

Parameter	Editor	Description
url	expression	The URL of the request. Supports expressions (e.g. = "https://api.com/clientes/" + id).

Optional parameters

Parameter	Editor	Description
headers	JSON	Dictionary of extra headers (name → value). See headers.
authorization	JSON	Authentication: bearer, basic or apikey. See authentication.

Output

Returns a ZoanHttpResponse with .StatusCode, .Ok, .Body and .Headers.

Example

Query a client by its id, authenticating with a secure token:

HTTP GET
  url = = "https://api.erp.com/clientes/" + clienteId
  authorization = { "type": "bearer", "token": = credential("api-erp").ToPlainText() }
  → output: resp

Set Variable   name = nombreCliente   value = = resp.Body["nombre"]
Log   message = = "Cliente: " + nombreCliente

Query parameters

The filters go in the URL itself as query string: https://api.com/pedidos?estado=pendiente&desde=2026-01-01. Construct it with an expression if the values ​​are dynamic.

Related activities

• HTTP POST — create or send data.
• Try / Catch — manejar respuestas de error.
• Data Types › ZoanHttpResponse — read the response.