Our House Employer API

Contents

Executive Summary

The Our House Employer API allows you to bypass manual job boards. By integrating, you can push vacancies from your ATS directly to resident mobile devices and receive structured, verified resume data in return.

Instant Reach

Push notifications to residents.

Structured JSON

No PDF parsing required.

Verified Talent

Pre-vetted community members.

Authentication

All requests must be authenticated using a Bearer Token. You can generate this key in your Employer Dashboard.

Your key starts with oh_live_. Treat this like a password. Do not share it in client-side code.

Header Format

Authorization: Bearer oh_live_b6e2de80aa60b52ea6e...

Posting a Job

Push a new vacancy. Jobs enter a pending state for 1-2 hours for human review before going live.

POST https://api.ourhouse.org/v1/jobs

cURL Example

curl -X POST \
  https://api.ourhouse.org/v1/jobs \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Logistics Associate",
    "salary": "$19.50/hr",
    "type": "Full-time",
    "location": "Columbus, OH"
  }'

Retrieving Applicants

Get a list of all candidates for a specific job ID.

GET https://api.ourhouse.org/v1/jobs/:jobId/applicants

Response (200 OK)

{
  "jobId": "job_8f7a2c91",
  "count": 1,
  "data": [
    {
      "id": "app_29183",
      "residentName": "Alex Smith",
      "appliedAt": 1707945600000,
      "resume": { ... }
    }
  ]
}

The Resume Object

Our House provides standardized, machine-readable JSON resumes. This structure allows you to map candidate skills directly to your internal fields.

personalInfo Object containing name, email, phone, location, summary.
experience[] Array of work history (Company, Title, Start/End, Description).
education[] Array of degrees and certifications.
skills[] Array of verified skills with proficiency (1-5).

Integration Checklist

Create Employer Account at ourhouse.org

Generate API Key in the dashboard

Test connection with cURL to /jobs

Map JSON Resume fields to your ATS

Go Live and start hiring!

Need help?

Contact Developer Support

Employer Integration Guide