Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Returns the headers of the transaction as text.

Component Version macOS Windows Linux Server iOS SDK
CURL 2.5 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes


This function was deprecated. Use CURL.GetHeaders instead.

MBS( "CURL.GetHeaderAsText"; curl { ; Encoding; preserveLineEndings } )   More


Parameter Description Example Flags
curl The CURL session handle. $curl
Encoding The text encoding for result.
Default is native. This function can also handle UTF-16 as well as UTF-16LE and UTF-16BE for little/big endian byte order.
Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ.
"UTF-8" Optional
preserveLineEndings Whether to change line endings to CR for FileMaker.
By default (0) we change the line endings to CR, so FileMaker has no trouble.
Pass 1 to keep whatever line endings are there.
0 Optional


The headers as text.


Returns the headers of the transaction as text.
You are responsible for detecting decoding.

Plugin version 5.2 and newer replace newlines automatically for you to match what FileMaker uses (Mac line endings).

Function renamed in v23.0 to CURL.GetHeaders. Old name will stay valid for the foreseeable future.


Get header lines:

MBS("CURL.GetHeaders”; $curl)

Get file name for container from header:

Set Variable [ $name ; Value: "" ]
Set Variable [ $headers ; Value: MBS( "CURL.GetHeaders”; $curl; "UTF-8") ]
Set Variable [ $headers ; Value: MBS( "List.MatchesPrefix"; $headers; "Content-Disposition: attachment; filename=") ]
If [ Length($headers) > 0 ]
    Set Variable [ $name ; Value: Middle ( $headers ; 43 ; Length($headers) ) ]
End If
Set Field [ CURL Test::File ; MBS("CURL.GetResultAsContainer"; $curl; $name) ]

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 3th January 2023

CURL.GetHeaderAsJSON - CURL.GetHeaderLength