Account

Definition

An Account represents a specific gig platform credential pair (identifier + platform) connected through Palenca for a given worker. One User can have multiple Accounts across different platforms. The account model contains relevant information such as the last time t connected successfully or warnings associated with it.

Profile Information for Gig Economy Accounts

Let's begin with a representative example of the profile information you could recover from our GET Account Endpoint:

{
  "success": true,
  "error": null,
  "data": {
    "account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "country": "mx",
    "platform": "uber",
    "identifier": "5512345678",
    "worker_id": "UBR-DRV-00412",
    "gov_id": "LOPM850312HDFPRS19",
    "last_successful_connection": "2026-04-15T10:30:00.000000+00:00",
    "warning": null,
    "status": "success",
    "status_details": null,
    "message": null,
    "recommendation": null,
    "next_step": null,
    "created_at": "2026-03-01T08:00:00.000000+00:00"
  }
}

Let's dive into a data dictionary.

Data Section

Data	Description	Type	Example
account_id	Unique identifier of the account in Palenca	string	a1b2c3d4-f5f6-7890-abcd-ef1234567790
country	ISO 3166-1 alpha-2 country code	string	mx
platform	Gig platform slug	string	uber
identifier	Credential used to log into the platform (phone or email)	string	5512345678
worker_id	Platform-assigned worker identifier	string \| null	UBR-DRV-00412
gov_id	Government ID associated with the account	string \| null	LOFM300312HDFPRS09
last_successful_connection	Timestamp of the last successful login	string \| null	2026-04-15T10:30:00.000000+00:00
warning	Warning code if data extraction was partial	string \| null	null
status	Current status: `success`, `incomplete`, `error`, `pending`	string	success
status_details	Specific sub-status code	string \| null	invalid_credentials
message	Human-readable message explaining the current status	string \| null	null
recommendation	Suggested action to resolve an issue	string \| null	null
next_step	Next action required to proceed	string \| null	null
created_at	Timestamp when the account was first created in Palenca	string	2026-03-01T08:00:00.000000+00:00