Skip to main content
GET
List Jobin operations
GET /operations lists persisted JobinJob operations visible to the authenticated API user. The default filter is exactly status=pending; other persisted states such as processing, THROTTLED, and QUOTA_REACHED are distinct and can be requested explicitly. The query accepts repeated status and codename parameters, plus queue, jobGroupId, campaignId, contactId, userLinkedinUrl, page, and limit. Page numbers start at 1 and are capped at 100. The result limit defaults to 25 and cannot exceed 25. For example, inspect pending LinkedIn invitations:
The response contains safe operational metadata only. It omits worker payloads and internal retry state and does not consume Jobin credits. count is the number of items on the returned page. total is the exact matching count under the same workgroup and sender visibility rules, regardless of page or limit. Use jobGroupId to correlate an asynchronous campaign assignment with currently outstanding operations:
No matching pending operations does not prove that the earlier assignment succeeded: jobs may have completed, failed, changed lifecycle state, or moved to a later sequence stage.

Authorizations

x-api-key
string
header
required

Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.

Query Parameters

status
enum<string>[]

Repeat to request multiple persisted JobinJob states. Defaults to pending.

Available options:
fail,
success,
pending,
processing,
blocked,
paused,
OUT_OF_TIMEFRAME,
THROTTLED,
SYNCHRONIZING,
COMPILING_SMART_FIELDS,
PENDING_HYDRATION,
UPSELL,
QUOTA_REACHED,
DISABLED
codename
string[]

Repeat to filter by one or more operation codenames, such as sendLinkedinInvite.

queue
enum<string>
Available options:
linkedin,
email,
sms,
jobin
jobGroupId
string
Pattern: ^[a-fA-F0-9]{24}$
campaignId
string
Pattern: ^[a-fA-F0-9]{24}$
contactId
string
Pattern: ^[a-fA-F0-9]{24}$
userLinkedinUrl
string<uri>
page
integer
default:1
Required range: 1 <= x <= 100
limit
integer
default:25
Required range: 1 <= x <= 25

Response

Bounded operations page

items
object[]
required
page
integer
required
limit
integer
required
count
integer
required

Number of items returned on this page.

total
integer
required

Exact number of matching persisted operations under the same workgroup, sender visibility, and filter rules, independent of page and limit.