Retrieve a job's forwarding address
Each job can have an address that members forward resumes to. Probb scans the attachments, matches each to an existing candidate and analyses it against the job. Returns the address with the analyses it has started this month against monthlyAnalysisCap, the files waiting and why, and the previous address while a rotation's grace period lasts. A job that never had an address is returned with status: off and address: null. Answers inbox_unavailable when the deployment does not receive email.
Required scope: inbox:read (inbox:write also works).
Errors
- 400:
unknown_field - 401:
authentication_required,invalid_api_key - 403:
api_access_disabled,insufficient_scope - 404:
resource_not_found - 422:
invalid_parameter - 429:
rate_limit_exceeded - 500:
api_error - 503:
inbox_unavailable,service_unavailable
ApiKeyAuthorizationBearer <probb_live_<id>_<secret>>jobId*stringThe job's ID.
1 <= length <= 200Success.
application/json- response
object*stringjobId*stringThe job this address feeds.
status*stringactive receives mail. off does not, and also describes a job that never had an address: address is null and monthlyAnalysisCap is the default.
"active""off"address*|The address members forward resumes to, or null while it is off.
previous*|The address before the last rotation, while it still accepts mail because the rotation asked for a grace period. Null otherwise.
monthlyAnalysisCap*integerThe most analyses this address starts per calendar month (UTC). The forward is the confirmation of the spend and this cap bounds it; there is no per-request maxCredits.
-9007199254740991 <= value <= 9007199254740991analysesThisMonth*integerAnalyses this address has started this UTC month.
-9007199254740991 <= value <= 9007199254740991waiting*Files from this address that are waiting, counted by the reason they wait (for example credits or the monthly cap).
updatedAt*stringdate-time# Set PROBB_URL and PROBB_API_KEY. Replace any *_VALUE placeholder and any example ID (such as job_example) with a real one.curl --fail-with-body -X GET "$PROBB_URL/api/v1/jobs/JOB_ID_VALUE/forwarding-address" \ -H "Authorization: Bearer $PROBB_API_KEY"{ "object": "forwarding_address", "jobId": "string", "status": "active", "address": "string", "previous": { "address": "string", "until": "2019-08-24T14:15:22Z" }, "monthlyAnalysisCap": -9007199254740991, "analysesThisMonth": -9007199254740991, "waiting": { "property1": -9007199254740991, "property2": -9007199254740991 }, "updatedAt": "2019-08-24T14:15:22Z"}