> ## Documentation Index
> Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ETL: BinaryCurl

> Makes a REST API call and returns the binary response received from the server. Requests are made either anonymous or with basic authentication.

## Description

Makes a REST API call and returns the binary response received from the server. Requests are made either anonymous or with basic authentication.

## Syntax

`BinaryCurl(url, method[, headers[, request_body[, username[, password]]]])`

## Arguments

*url* - HTTP or HTTPS url for the request.

*method* - HTTP method, such as GET, POST, PUT, DELETE.

*headers* (optional) - A json string that identifies the header key and value in the following manner: `'{"header1" : "value1" , "header2" : "value2"}'`

*request\_body* (optional) - The string body of the request (most relevant in the case of POST)

*username (optional) - The user name for basic authentication. Can be empty string if the site does not require authentication.*

*password* (optional) - The password for basic authentication. Can be empty string if the site does not require authentication.

## Examples

`BinaryCurl('http://api.myapp.com/users/','POST','{"Accept":"text/json"}','{"name":"John","age":34}','myuser','mypass')`

`BinaryCurl('http://api.myapp.com/users/','GET')`

## Return value datatype

The returned value is a map object that contains the following keys:

* status - response code (integer)
* body - the body of the response (binary)
* headers - map object of response headers

## Impact of null value

The url and method arguments are required. The rest are optional and default to null.