# Contact List Signup List

Retrieve details about all contact list signup requests via a subscription widget. Provides details on signup and subscription confirmation IPs, timestamp, subscription source etc.

Endpoint: GET /v3/REST/contactslistsignup
Version: 1.0.0
Security: basicAuth

## Query parameters:

  - `Contact` (integer)
    Retrieves only signup requests for a given contact ID.

  - `ContactsList` (integer)
    Retrieves only signup requests to a given contact list ID.

  - `Domain` (string)
    Retrieves only signup requests for contacts with the specified domain. Required, if the LocalPart query parameter is used as well.

  - `Email` (string)
    Retrieves only signup requests for the specified email address.

  - `LocalPart` (string)
    Retrieves only signup requests for emails with the specified local part. If this query parameter is used, the Domain query parameter is required as well.

  - `MaxConfirmAt` (integer)
    Retrieves only signup requests, where the subscription confirmation was done earlier than the specified timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted.

  - `MaxSignupAt` (integer)
    Retrieves only signup requests, where the request was done before the specified timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted.

  - `MinConfirmAt` (integer)
    Retrieves only signup requests, where the subscription confirmation was done after the specified timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted.

  - `MinSignupAt` (integer)
    Retrieves only signup requests, where the request was done after the specified timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted.

  - `SignupIp` (string)
    Retrieves only signup requests, which were done from the specified IP address.

  - `Source` (string)
    Retrieves only signup requests, which were done from the specified source type.

  - `SourceID` (integer)
    Retrieves only signup requests done via the respective source ID. This would be the ID of the widget used for the request.

## Response 200 fields (application/json):

  - `Count` (integer)
    Indicates the number of objects in the Data array.

  - `Data` (array)
    A JSON array containing a list of objects returned by this endpoint.

  - `Data.ConfirmAt` (integer)
    Unix timestamp indicating when the contact completed the subscription confirmation.

  - `Data.ConfirmIp` (string)
    The IP address detected during the subscription confirmation.

  - `Data.ContactID` (integer)
    Unique numeric ID of the contact that made the subscription request.

  - `Data.Email` (string)
    Email address of the contact that made the subscription request.

  - `Data.ID` (integer)
    Unique numeric ID assigned to this subscription request.

  - `Data.ListID` (integer)
    Unique numeric ID of the contact list, to which the contact was subscribed.

  - `Data.SignupAt` (integer)
    Unix timestamp indicating when the contact made the subscription request.

  - `Data.SignupIp` (string)
    IP address detected when making the subscription request.

  - `Data.SignupKey` (string)
    Unique confirmation key, which will be added to the URL the contact will receive in their subscription confirmation email.

  - `Data.SourceId` (integer)
    The ID of the widget used for the subscription request.

  - `Data.Source` (string)
    Indicates the source, from which the signup request came.

  - `Total` (integer)
    Indicates the number of objects in the Data array.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields