Skip to main content
GET
/
v2
/
accounts
List all accounts
curl --request GET \
  --url https://api-sandbox.argyle.com/v2/accounts \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "id": "0185a8b8-60eb-80ca-7482-5f24504573f7",
    "user": "0186c5b8-8fa1-67b3-39af-14b3e18da8a7",
    "employers": [
      "Half Bads"
    ],
    "item": "item_000000001",
    "source": "payrollcorp",
    "created_at": "2023-01-30T18:25:13.491Z",
    "updated_at": "2023-01-30T18:46:44.034Z",
    "scanned_at": "2023-01-30T18:46:43.446Z",
    "connection": {
      "status": "connected",
      "error_code": null,
      "error_message": null,
      "updated_at": "2023-01-30T18:25:30.334956Z",
      "direct_deposit_switch": {
        "status": "error",
        "error_code": "confirmation_timeout",
        "error_message": "This user did not finish confirming the direct deposit switch.",
        "updated_at": "2023-01-30T18:35:31.961Z"
      }
    },
    "availability": {
      "shifts": {
        "status": "synced",
        "updated_at": "2023-01-30T18:46:43Z",
        "available_count": 132,
        "available_from": "2020-03-03T18:25:30Z",
        "available_to": "2023-01-28T00:00:00Z"
      },
      "gigs": {
        "status": "synced",
        "updated_at": "2023-01-30T18:46:43Z",
        "available_count": 242,
        "available_from": "2020-03-03T18:25:30Z",
        "available_to": "2023-01-28T00:00:00Z"
      },
      "paystubs": {
        "status": "synced",
        "updated_at": "2023-01-30T18:46:43Z",
        "available_count": 40,
        "available_from": "2020-03-03T18:25:30Z",
        "available_to": "2023-01-02T00:00:00Z"
      },
      "payroll_documents": {
        "status": "synced",
        "updated_at": "2023-01-30T18:45:35.228Z"
      },
      "identities": {
        "status": "synced",
        "updated_at": "2023-01-30T18:45:34.960Z"
      },
      "ratings": {
        "status": "synced",
        "updated_at": "2023-01-30T18:45:35.235Z"
      },
      "vehicles": {
        "status": "synced",
        "updated_at": "2023-01-30T18:45:35.237Z"
      },
      "deposit_destinations": {
        "status": "synced",
        "updated_at": "2023-01-30T18:25:31.438Z"
      },
      "user_forms": null,
      "user_uploads": null
    },
    "ongoing_refresh": {
      "status": "enabled"
    }
  },
  {
    "id": "01856c65-43b6-8b5d-b32a-56b8fbda5c28",
    "user": "0186c5b8-8fa1-67b3-39af-14b3e18da8a7",
    "employers": [],
    "item": "item_000012271",
    "source": "doc_upload_item",
    "created_at": "2023-01-30T15:15:53.176Z",
    "updated_at": "2023-01-30T15:16:12.042Z",
    "scanned_at": null,
    "connection": {
      "status": "connecting",
      "error_code": null,
      "error_message": null,
      "updated_at": "2023-01-30T15:16:14.695Z"
    },
    "direct_deposit_switch": {
      "status": "idle",
      "error_code": null,
      "error_message": null,
      "updated_at": "2023-01-30T15:16:11.703Z"
    },
    "availability": {
      "shifts": null,
      "gigs": null,
      "paystubs": null,
      "payroll_documents": null,
      "identities": null,
      "ratings": null,
      "vehicles": null,
      "deposit_destinations": null,
      "user_forms": {
        "status": "synced",
        "updated_at": "2023-01-30T15:16:12.012Z",
        "available_count": 1,
        "files_count": 3,
        "in_progress_count": 0
      },
      "user_uploads": null
    },
    "ongoing_refresh": {
      "status": "idle"
    }
  }
]

Authorizations

​
Authorization
string
header
required

Username = api_key_id, Password = api_key_secret

Query Parameters

​
user
string<uuid>

Filter by user ID.

​
item
string<uuid>

Filter by Item ID.

​
ongoing_refresh_status
enum<string>

Filter by status of the ongoing_refresh object.

Available options:
enabled,
disabled,
idle
​
limit
integer

Number of account objects returned per page. Default: 10. Maximum: 200.

Response

200 - application/json
​
id
string<uuid>

Unique ID of the connected payroll account.

​
user
string<uuid>

ID of the user that connected the account.

​
employers
string[]

Employers associated with the account.

A single employer is usually returned per account. Exceptions can occur when an LLC and Co. version of the same employer is returned.

​
item
string

ID of the Item in Link through which the account was connected.

​
source
string

Payroll data source. Typically a third-party payroll system unless the employer uses an in-house system.

​
created_at
string<datetime>

Timestamp (ISO 8601) when the user connected the account.

​
updated_at
string<datetime>

Timestamp (ISO 8601) when the account was last updated. An update occurs every time an account is scanned for new data, and when any values of the account object change (such as an updated connection status).

​
scanned_at
string<datetime>

Timestamp (ISO 8601) when the account was last scanned for new data. A null value indicates the account was never connected.

​
connection
object

Object containing information about the account's connection status.

​
direct_deposit_switch
object

Object containing deposit switch status information.

​
availability
object

Object containing information on data availability for each of Argyle's data sets, and any user-uploaded documents or "can't find my income" response forms.

​
ongoing_refresh
object

Object containing the account's ongoing_refresh status (whether the account will be updated with new data after each data refresh).