Offers

List all offers for the authenticated employer

get/offers

Request

  • Base URL
    https://app.hireart.com/api/v2
  • Auth
    HTTP bearer

Query parameters

pageinteger

Page number

per_pageinteger

Number of results per page

worker_idstring

Filter by worker id

job_idstring

Filter by job id

employer_start_datestring date

Employer start date is on this date (YYYY-MM-DD)

employer_start_date_gtstring date

Employer start date is after this date (YYYY-MM-DD)

employer_start_date_gtestring date

Employer start date is on or after this date (YYYY-MM-DD)

employer_start_date_ltstring date

Employer start date is before this date (YYYY-MM-DD)

employer_start_date_ltestring date

Employer start date is on or before this date (YYYY-MM-DD)

Response

Successful response

object'list' required
pageinteger required
per_pageinteger required
total_countinteger required
total_pagesinteger required

Example response

{
  "page": 1,
  "per_page": 25,
  "total_count": 42,
  "total_pages": 2,
  "data": [
    {
      "object": "offer",
      "id": "97811bd6-539f-4a58-8be3-6bbe3acfdae0",
      "status": "pending",
      "status_changed_at": "2024-06-15T14:30:00Z",
      "additional_details": "Hybrid schedule, 3 days on-site.",
      "terms": [
        {
          "object": "offer_term",
          "type": "salary",
          "amount_cents": 15000,
          "currency": "USD",
          "cadence": "annually",
          "context": "Performance bonus",
          "start_date": "2024-06-15"
        }
      ],
      "employer_start_date": "2024-06-15",
      "employer_start_preference": "as_soon_as_possible",
      "initiated_at": "2024-06-15T14:30:00Z",
      "references_checked_at": "2024-06-15T14:30:00Z",
      "sent_at": "2024-06-15T14:30:00Z",
      "job": {
        "object": "job",
        "id": "97811bd6-539f-4a58-8be3-6bbe3acfdae0",
        "name": "Customer Support Specialist",
        "employer_name": "Acme Corp",
        "employer_id": "1aecf7c8-9d70-433a-9bb5-473cf4907a86",
        "logo_url": "https://cdn.example.com/image.jpg"
      },
      "applicant": {
        "object": "person",
        "id": "97811bd6-539f-4a58-8be3-6bbe3acfdae0",
        "full_name": "Jane Doe",
        "first_name": "Jane",
        "last_name": "Doe",
        "email": "jane.doe@example.com",
        "phone": "+1 (555) 555-5555"
      },
      "application_id": "e3d53e91-6187-4184-a084-75a7532e5fca",
      "worker_id": "1ccf6e61-376c-47d3-8a63-a8ee112e83a2",
      "created_at": "2024-06-15T14:30:00Z",
      "updated_at": "2024-06-15T14:30:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.