Skip to main content

Get User List Upload Job

Loading...
API endpoint path: /pss/v1/fis/{fiId}/audiences/userListJobs/{jobId}

Retrieves the current status and progress of a user list upload job identified by jobId.

Use this endpoint to:

  • Track upload progress after a job is accepted.
  • Confirm when a user list is available in Promotions Suite for campaign targeting.
  • Review validation errors and failed member IDs when a job does not complete successfully.

Behavior and capabilities:

  • jobId must match the value returned by the Create User List Upload Job.
  • Job status is retained for 30 days after completion.
  • status.code progresses through Converting, Committing, Uploading, and Completed; failed jobs return Failed.
  • memberIdsCount and validMemberIdsCount remain 0 until conversion reports counts.
  • User lists are available in Promotions Suite starting in the Uploading state.
  • The response includes jobId, listName, fiId, member counts, status, and startTimestamp.

Request​

Responses​

Success