ProZ.com global directory of translation services
The translation workplace
Ideas

GET: /job-posting/:id

Get a single job posting by ID, along with the poster's Blue Board summary data.

Parameters

  • id: The job posting ID.

Example request

curl -H "Authorization: Bearer {OAUTH2_ACCESS_TOKEN}" https://api.proz.com/v2/job-posting/12345

Response

Nested object containing:

  • job_posting: a job posting object/li>
  • blueboard_summary: the associated Blue Board summary object
  • meta: An object containing information about the viewer's relationship to the job:
    • quote_eligibility: An object containing information about the authenticated user's ability to submit a quote for the job. Fields:
      • can_quote: Whether the user can currently submit a quote for this job, regardless of the contact_method of the job. If contact_method is proz, the user can submit a quote via the ProZ.com API or website. Any other contact_method requires the user to contact the outsourcer directly.
      • meets_restrictions: Whether the user meets the restrictions placed by the outsourcer on who can quote on the job, regardless of whether or not they can currently quote on the job.
      • messages: An array of strings describing any unmet job restrictions.
    • quote_email: If contact_method is "email" and can_quote is true, this will be the email address to which quotes should be sent. Otherwise null .
    • discard: If the user has discarded this job, this will have information it:
      • time_discarded: The time the user marked the job as discarded.
      • reason: An optional reason for discarding the job.

{
  "job_posting": {
    "id": 739492,
    "web_url": "http://www.proz.com/job/739492",
    "type": "potential",
    "summary": "Russian>German Legal Translation",
    "description": "Geotext Translations is currently recruiting Russian>German linguists for a large Legal translation project.\r\n\r\nWe are looking for linguists specialized in legal translation who are available immediately for a long-term freelance collaboration.\r\n\r\nA test may be required.\r\n\r\nIf you are interested in collaborating, please send your CV and most competitive rates to [email protected]",
    "status": "open",
    "time_posted": "2013-02-15T17:44:07+00:00",
    "time_expires": "2013-02-20T22:00:00+00:00",
    "delivery_deadline": null,
    "language_pairs": [
      "rus_deu"
    ],
    "volume_amount": 0,
    "volume_unit": "word",
    "disc_spec_id": 77,
    "disc_other": "",
    "language_service_ids": [
      1,
      2
    ],
    "contact_method": "email",
    "contact_info": {
      "user_id": 964006,
      "type": "company",
      "email": "",
      "show_email": false,
      "full_name": "",
      "show_full_name": false,
      "job_title": "Recruitment Coordinator",
      "company": "Geotext Translations",
      "url": "http://www.geotext.com",
      "show_url": true,
      "address": "259 W. 30th St. 17th Fl.",
      "show_address": true,
      "city": "New York",
      "show_city": true,
      "region": "New York",
      "show_region": true,
      "postal_code": "10001",
      "show_postal_code": true,
      "country": "us",
      "show_country": true,
      "phone": "",
      "show_phone": false,
      "fax": "",
      "show_fax": false
    },
    "software_ids": [],
    "offered_rate": null,
    "payment_notes": "",
    "blueboard_name": "Geotext Translations, Inc.",
    "blueboard_avg_lwa": 5,
    "blueboard_link": "https://api.proz.com/v2/blueboard/3856",
    "provider_requirements": {
        "proz_members_only": true,
        "members_only_until": null,
        "language_pairs": [ "rus_deu" ],
        "language_pair_importance": "required",
        "disc_gen_ids": [ 1 ],
        "disc_gen_importance": "required",
        "disc_spec_ids": [ 77 ],
        "disc_spec_importance": "preferred",
        "credentials": null,
        "native_language": "deu",
        "native_language_importance": "required",
        "software": [],
        "software_importance": null,
        "country": "us",
        "country_importance": "preferred",
        "account_type": "freelancers",
        "account_type_importance": "required",
        "additional_requirements": "Must have at least 10 years of experience."
    },
    "confidentiality": "high",
    "text_excerpt": "",
    "text_excerpt_require_translation": false,
    "_links": {
      "self": {
        "href": "https://api.proz.com/v2/job-postings/739492"
      }
    }
}
,
  "blueboard_summary": {
    "id": 3856,
    "web_url": "http://www.proz.com/blueboard/3856",
    "name": "Geotext Translations, Inc.",
    "country": "us",
    "overall_lwa_avg": 5,
    "overall_lwa_num_entries": 27,
    "12mo_lwa_avg": null,
    "12mo_lwa_num_entries": 0,
    "_links": {
      "self": {
        "href": "https://api.proz.com/v2/blueboard/3856"
      }
    }
  },
  "meta": {
    "quote_eligibility": {
      "can_quote": false,
      "messages": [
        "Job poster did not elect to receive quotes via ProZ.com."
      ]
    },
    "quote_email": null,
    "discard": {
      "time_discarded": "2016-02-10 18:37:07",
      "reason": "Some reason."
    }
  }
}