NAV
http

Introduction

The Proof API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

API URLs

Environment URL
Staging https://api.staging.proofserve.com/v1/
Trunk https://api.trunk.proofserve.com/v1/
Production https://api.proofserve.com/v1/

Authentication

Example authenticated request:

# With http, you can just pass the correct header with each request
curl "<ENDPOINT>"
  -H "Authorization: <API_KEY>"

Make sure to replace <API_KEY> with your API key. You can generate an API key by logging in and going to Billing & Configuration > API.

Authentication to the API is performed via HTTP Basic Auth. Provide your API key as the basic auth username value. You do not need to provide a password. API keys can be generated within the web app in the Billing & Configuration > API page.

Errors

Proof uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, the request failed, etc.). Codes in the 5xx range indicate an error with Proof's servers (these are rare).

Rate limit

All accounts start off with a rate limit of 1,800 requests per minute. If you make over 1,800 requests in a given minute, your requests will begin returning 429 status codes. If you need a higher limit, please contact Proof. A basic technique for integrations to gracefully handle limiting is to watch for 429 status codes and build in a retry mechanism. The retry mechanism should follow an exponential backoff schedule to reduce request volume when necessary.

Attempt Photos

Get attempt photo

Example response:

<image file>

HTTP Request

GET /attempt-photos/{attempt_photo_id}.{ext}

Billing

Get payment methods

Example response:

[
  {
    "id": 1,
    "brand": "Visa",
    "last4": "4242",
    "address_zip": "12321",
    "billing_name": "Martin",
    "exp_month": 4,
    "exp_year": 2024,
    "default": true,
    "shared": false,
    "user_id": 2,
    "label": "Abc",
    "stripe_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
    "type": "CARD",
    "status": "CONFIRMED"
  }
]

HTTP Request

GET /billing/payment-methods

Documents

Upload document

Example request body:

"<file>"

Example response:

{
  "document": {
    "filename": "file.pdf",
    "size": 13264,
    "page_count": "1",
    "extension": "pdf",
    "law_firm_id": 2,
    "created_by_id": 2,
    "updated_at": 1625161312000,
    "created_at": 1625161312000,
    "id": 893
  },
  "title": null,
  "court_name": null,
  "court_address": null,
  "case_number": null,
  "billing_number": null,
  "court_date": null,
  "plaintiffs": null,
  "defendants": null,
  "multiple_documents": null,
  "page_count": null
}

HTTP Request

POST /documents

File should be sent as multipart/form-data with the file sent under the file key.

In supported states we will attempt to parse and return pertinent information from the PDF file (e.g. document title, court name, plaintiffs, etc.). This data should be verified by the user before submitted.

Get document

Example response:

<pdf file>

HTTP Request

GET /documents/{document_id}.{ext}

Export

Export jobs (csv)

Example response:

<csv file>

HTTP Request

GET /export/{start}/{end}/csv

URL Parameters

Parameter Description
start
integer, required
UNIX Timestamp in milliseconds
end
integer, required
UNIX Timestamp in milliseconds

Invoices

Get invoices

Example response:

{
  "current_page": 1,
  "last_page": 3,
  "per_page": 10,
  "total": 25,
  "data": [
    {
      "id": 4,
      "user_id": 2,
      "law_firm_id": 2,
      "job_id": 8,
      "total": 75,
      "paid_amount": 75,
      "paid": true,
      "created_at": 1548853797000,
      "updated_at": 1548853797000,
      "deleted_at": null,
      "balance": 0,
      "line_items": [
        {
          "id": 1,
          "invoice_id": 4,
          "name": "Standard Serve (Base Fee)",
          "description": "Servee: John Doe\nCase Number: C12345\nAttempts Made: 2\n",
          "price": 25,
          "quantity": 1,
          "total": "25.0000000000",
          "created_at": 1548853846000,
          "updated_at": 1548853846000,
          "deleted_at": null
        },
        {
          "id": 2,
          "invoice_id": 4,
          "name": "Standard Serve (Bounty)",
          "description": "Serve Date: 02/10/2019",
          "price": 50,
          "quantity": 1,
          "total": "50.0000000000",
          "created_at": 1548853846000,
          "updated_at": 1548853846000,
          "deleted_at": null
        }
      ],
      "user": {
        "id": 2,
        "law_firm_id": 2,
        "type": "FIRM",
        "name": "Marty Wachocki",
        "last_name": "Wachocki",
        "first_name": "Marty",
        "active": 1,
        "email": "firm@proofserve.com",
        "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
        "email_invoices": true,
        "email_notifications": true,
        "email_verified": true,
        "administrator": true,
        "phone_number": "7347304250",
        "address_1": "7154 Eaton Ct",
        "address_2": null,
        "city": "Arvada",
        "state_id": 1,
        "zip": "80003",
        "created_at": 1548158103000,
        "updated_at": 1608152958000,
        "deleted_at": null,
        "new_user": 0,
        "rating_count": 0,
        "email_chat_messages": 1,
        "email_progress_updates": 1,
        "email_reassigned": 1,
        "email_job_completed": 1,
        "notify_hours": 1,
        "total_job_count": 0,
        "total_job_count_5_stars": 0,
        "table_style": "DEFAULT",
        "coupon_code": null,
        "last_cdp_update": null,
        "email_affidavits": false
      },
      "job": {
        "id": 8,
        "user_id": 2,
        "law_firm_id": 2,
        "server_id": 6,
        "original_job_id": null,
        "new_job_id": 50,
        "status": "IN_PROGRESS",
        "contact_first_name": "",
        "contact_last_name": "",
        "contact_email": "",
        "contact_phone": null,
        "billing_number": "A00012345",
        "court_name": "Jefferson County District Court",
        "case_number": "CL35832",
        "state_id": 1,
        "serve_pricing_id": 1,
        "stripe_card_id": "card_1Dy074Hg213tM5vxjBic4l40",
        "post_serve": false,
        "assign_date": null,
        "created_by_id": 2,
        "attempts_made": 2,
        "last_attempt": "2019-03-27 16:30:34",
        "successful_attempt": false,
        "successful_at": null,
        "completed_at": null,
        "due_date": 1548435181000,
        "originated_at": 1548340763000,
        "subpoena": false,
        "witness_fee": null,
        "authorize_skiptrace": true,
        "affidavit_extension": "pdf",
        "review_period_ends": null,
        "created_at": 1548340763000,
        "updated_at": 1581529725000,
        "deleted_at": null,
        "same_address_job_id": null,
        "attorney_name": null,
        "attorney_bar_number": null,
        "court_street_address": null,
        "court_mailing_address": null,
        "court_city": null,
        "court_zip": null,
        "court_branch_name": null,
        "court_address": null,
        "last_status_change": null,
        "court_date": null,
        "affidavit_status": "PENDING_TM_REVIEW",
        "cancel_job_reason": null,
        "affidavit_uploaded_at": "2020-10-04 01:07:06",
        "salesforce_id": null,
        "archived": false,
        "off_app_assigned_to": "NOT_ASSIGNED",
        "salesforce_user_id": "",
        "affidavit_due_at": null,
        "affidavit_reminders_sent": 0,
        "last_affidavit_reminder_sent_at": null,
        "attempt_reminders_sent": 0,
        "last_attempt_reminder_sent_at": null,
        "signed_affidavit_url": null,
        "base_fee": 25,
        "bounty": 50,
        "post_price": 45,
        "servee": {
          "id": 7,
          "type": "INDIVIDUAL",
          "job_id": 8,
          "name": "Jane Smith",
          "registered_agent_name": null,
          "physical_description": true,
          "race": "White",
          "gender": "Male",
          "hair_color": "Brown",
          "marital_status": "Married",
          "eye_glasses": "Yes",
          "height": "5' 9\" to 6'",
          "weight": "160 to 180 lbs",
          "age": 30,
          "notes": "He works from 9-5\nCompany name is Propel Technology",
          "social_links": "https://www.facebook.com/propelitco/",
          "created_at": 1548083163000,
          "updated_at": 1548083163000,
          "deleted_at": null,
          "primary_address": {
            "id": 18,
            "servee_id": 7,
            "type": "HOME",
            "business_name": null,
            "address_1": "7154 Eaton Ct",
            "address_2": "",
            "city": "Arvada",
            "state_id": 1,
            "zip": "80003",
            "primary": true,
            "longitude": -105.0596457,
            "latitude": 39.8252367,
            "county": "Jefferson County",
            "created_at": 1548345974000,
            "updated_at": 1558672808000,
            "deleted_at": null,
            "timezone": "America/Denver"
          }
        },
        "serve_pricing": {
          "id": 1,
          "name": "Standard",
          "state_id": 1,
          "base_fee": 25,
          "bounty_fee": 50,
          "diy_price": 75,
          "post_price": 45,
          "post_duration": 172800,
          "initial_duration": 604800,
          "total_duration": 604800,
          "total_attempts": 4,
          "updated_at": 1548331771000,
          "created_at": 1548331771000,
          "creditor_only": 0,
          "collection_only": 0
        },
        "user": {
          "id": 2,
          "law_firm_id": 2,
          "type": "FIRM",
          "name": "Marty Wachocki",
          "last_name": "Wachocki",
          "first_name": "Marty",
          "active": 1,
          "email": "firm@proofserve.com",
          "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
          "email_invoices": true,
          "email_notifications": true,
          "email_verified": true,
          "administrator": true,
          "phone_number": "7347304250",
          "address_1": "7154 Eaton Ct",
          "address_2": null,
          "city": "Arvada",
          "state_id": 1,
          "zip": "80003",
          "created_at": 1548158103000,
          "updated_at": 1608152958000,
          "deleted_at": null,
          "new_user": 0,
          "rating_count": 0,
          "email_chat_messages": 1,
          "email_progress_updates": 1,
          "email_reassigned": 1,
          "email_job_completed": 1,
          "notify_hours": 1,
          "total_job_count": 0,
          "total_job_count_5_stars": 0,
          "table_style": "DEFAULT",
          "coupon_code": null,
          "last_cdp_update": null,
          "email_affidavits": false
        }
      }
    }
  ]
}

HTTP Request

GET /invoices

Get invoice

Example response:

{
  "id": 4,
  "user_id": 2,
  "law_firm_id": 2,
  "job_id": 8,
  "total": 75,
  "paid_amount": 75,
  "paid": true,
  "created_at": 1548853797000,
  "updated_at": 1548853797000,
  "deleted_at": null,
  "balance": 0,
  "line_items": [
    {
      "id": 1,
      "invoice_id": 4,
      "name": "Standard Serve (Base Fee)",
      "description": "Servee: John Doe\nCase Number: C12345\nAttempts Made: 2\n",
      "price": 25,
      "quantity": 1,
      "total": "25.0000000000",
      "created_at": 1548853846000,
      "updated_at": 1548853846000,
      "deleted_at": null
    },
    {
      "id": 2,
      "invoice_id": 4,
      "name": "Standard Serve (Bounty)",
      "description": "Serve Date: 02/10/2019",
      "price": 50,
      "quantity": 1,
      "total": "50.0000000000",
      "created_at": 1548853846000,
      "updated_at": 1548853846000,
      "deleted_at": null
    }
  ],
  "user": {
    "id": 2,
    "law_firm_id": 2,
    "type": "FIRM",
    "name": "Marty Wachocki",
    "last_name": "Wachocki",
    "first_name": "Marty",
    "active": 1,
    "email": "firm@proofserve.com",
    "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
    "email_invoices": true,
    "email_notifications": true,
    "email_verified": true,
    "administrator": true,
    "phone_number": "7347304250",
    "address_1": "7154 Eaton Ct",
    "address_2": null,
    "city": "Arvada",
    "state_id": 1,
    "zip": "80003",
    "created_at": 1548158103000,
    "updated_at": 1608152958000,
    "deleted_at": null,
    "new_user": 0,
    "rating_count": 0,
    "email_chat_messages": 1,
    "email_progress_updates": 1,
    "email_reassigned": 1,
    "email_job_completed": 1,
    "notify_hours": 1,
    "total_job_count": 0,
    "total_job_count_5_stars": 0,
    "table_style": "DEFAULT",
    "coupon_code": null,
    "last_cdp_update": null,
    "email_affidavits": false
  },
  "law_firm": {
    "id": 2,
    "name": "Acme Law Firm",
    "phone_number": "7347304250",
    "email": "marty@wachocki.net",
    "address_1": "8753 Yates Dr",
    "address_2": "#215",
    "city": "Westminster",
    "state_id": 1,
    "zip": "80031",
    "created_at": 1548272881000,
    "updated_at": 1607363359000,
    "deleted_at": null,
    "email_invoices_to": null,
    "free_credits": "475.0000000000",
    "api_enabled": true,
    "private_jobs": false,
    "salesforce_connected": true
  },
  "job": {
    "id": 8,
    "user_id": 2,
    "law_firm_id": 2,
    "server_id": 6,
    "original_job_id": null,
    "new_job_id": 50,
    "status": "IN_PROGRESS",
    "contact_first_name": "",
    "contact_last_name": "",
    "contact_email": "",
    "contact_phone": null,
    "billing_number": "A00012345",
    "court_name": "Jefferson County District Court",
    "case_number": "CL35832",
    "state_id": 1,
    "serve_pricing_id": 1,
    "stripe_card_id": "card_1Dy074Hg213tM5vxjBic4l40",
    "post_serve": false,
    "assign_date": null,
    "created_by_id": 2,
    "attempts_made": 2,
    "last_attempt": "2019-03-27 16:30:34",
    "successful_attempt": false,
    "successful_at": null,
    "completed_at": null,
    "due_date": 1548435181000,
    "originated_at": 1548340763000,
    "subpoena": false,
    "witness_fee": null,
    "authorize_skiptrace": true,
    "affidavit_extension": "pdf",
    "review_period_ends": null,
    "created_at": 1548340763000,
    "updated_at": 1581529725000,
    "deleted_at": null,
    "same_address_job_id": null,
    "attorney_name": null,
    "attorney_bar_number": null,
    "court_street_address": null,
    "court_mailing_address": null,
    "court_city": null,
    "court_zip": null,
    "court_branch_name": null,
    "court_address": null,
    "last_status_change": null,
    "court_date": null,
    "affidavit_status": "PENDING_TM_REVIEW",
    "cancel_job_reason": null,
    "affidavit_uploaded_at": "2020-10-04 01:07:06",
    "salesforce_id": null,
    "archived": false,
    "off_app_assigned_to": "NOT_ASSIGNED",
    "salesforce_user_id": "",
    "affidavit_due_at": null,
    "affidavit_reminders_sent": 0,
    "last_affidavit_reminder_sent_at": null,
    "attempt_reminders_sent": 0,
    "last_attempt_reminder_sent_at": null,
    "signed_affidavit_url": null,
    "base_fee": 25,
    "bounty": 50,
    "post_price": 45,
    "servee": {
      "id": 7,
      "type": "INDIVIDUAL",
      "job_id": 8,
      "name": "Jane Smith",
      "registered_agent_name": null,
      "physical_description": true,
      "race": "White",
      "gender": "Male",
      "hair_color": "Brown",
      "marital_status": "Married",
      "eye_glasses": "Yes",
      "height": "5' 9\" to 6'",
      "weight": "160 to 180 lbs",
      "age": 30,
      "notes": "He works from 9-5\nCompany name is Propel Technology",
      "social_links": "https://www.facebook.com/propelitco/",
      "created_at": 1548083163000,
      "updated_at": 1548083163000,
      "deleted_at": null,
      "primary_address": {
        "id": 18,
        "servee_id": 7,
        "type": "HOME",
        "business_name": null,
        "address_1": "7154 Eaton Ct",
        "address_2": "",
        "city": "Arvada",
        "state_id": 1,
        "zip": "80003",
        "primary": true,
        "longitude": -105.0596457,
        "latitude": 39.8252367,
        "county": "Jefferson County",
        "created_at": 1548345974000,
        "updated_at": 1558672808000,
        "deleted_at": null,
        "timezone": "America/Denver"
      }
    },
    "serve_pricing": {
      "id": 1,
      "name": "Standard",
      "state_id": 1,
      "base_fee": 25,
      "bounty_fee": 50,
      "diy_price": 75,
      "post_price": 45,
      "post_duration": 172800,
      "initial_duration": 604800,
      "total_duration": 604800,
      "total_attempts": 4,
      "updated_at": 1548331771000,
      "created_at": 1548331771000,
      "creditor_only": 0,
      "collection_only": 0
    },
    "user": {
      "id": 2,
      "law_firm_id": 2,
      "type": "FIRM",
      "name": "Marty Wachocki",
      "last_name": "Wachocki",
      "first_name": "Marty",
      "active": 1,
      "email": "firm@proofserve.com",
      "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
      "email_invoices": true,
      "email_notifications": true,
      "email_verified": true,
      "administrator": true,
      "phone_number": "7347304250",
      "address_1": "7154 Eaton Ct",
      "address_2": null,
      "city": "Arvada",
      "state_id": 1,
      "zip": "80003",
      "created_at": 1548158103000,
      "updated_at": 1608152958000,
      "deleted_at": null,
      "new_user": 0,
      "rating_count": 0,
      "email_chat_messages": 1,
      "email_progress_updates": 1,
      "email_reassigned": 1,
      "email_job_completed": 1,
      "notify_hours": 1,
      "total_job_count": 0,
      "total_job_count_5_stars": 0,
      "table_style": "DEFAULT",
      "coupon_code": null,
      "last_cdp_update": null,
      "email_affidavits": false
    }
  },
  "payments": [
    {
      "id": 1,
      "invoice_id": 4,
      "stripe_customer_id": "",
      "stripe_card_id": "",
      "stripe_charge_id": "",
      "type": "STRIPE",
      "card_brand": "Visa",
      "card_name": "Marty's Card",
      "card_last_4": "8030",
      "amount": 75,
      "notes": null,
      "created_at": 1550065265000,
      "updated_at": 1550065265000,
      "deleted_at": null
    }
  ]
}

HTTP Request

GET /invoices/{invoice_id}

Get invoice pdf

Example response:

<pdf file>

HTTP Request

GET /invoices/{invoice_id}/pdf

Jobs

Get all jobs

Example response:

{
  "current_page": 1,
  "last_page": 16,
  "per_page": 10,
  "total": 153,
  "data": [
    {
      "id": 8,
      "user_id": 2,
      "law_firm_id": 2,
      "server_id": 6,
      "original_job_id": null,
      "new_job_id": 50,
      "status": "IN_PROGRESS",
      "contact_first_name": "",
      "contact_last_name": "",
      "contact_email": "",
      "contact_phone": null,
      "billing_number": "A00012345",
      "court_name": "Jefferson County District Court",
      "case_number": "CL35832",
      "state_id": 1,
      "serve_pricing_id": 1,
      "stripe_card_id": "card_1Dy074Hg213tM5vxjBic4l40",
      "post_serve": false,
      "assign_date": null,
      "created_by_id": 2,
      "attempts_made": 2,
      "last_attempt": "2019-03-27 16:30:34",
      "successful_attempt": false,
      "successful_at": null,
      "completed_at": null,
      "due_date": 1548435181000,
      "originated_at": 1548340763000,
      "subpoena": false,
      "witness_fee": null,
      "authorize_skiptrace": true,
      "affidavit_extension": "pdf",
      "review_period_ends": null,
      "created_at": 1548340763000,
      "updated_at": 1581529725000,
      "deleted_at": null,
      "same_address_job_id": null,
      "attorney_name": null,
      "attorney_bar_number": null,
      "court_street_address": null,
      "court_mailing_address": null,
      "court_city": null,
      "court_zip": null,
      "court_branch_name": null,
      "court_address": null,
      "last_status_change": null,
      "court_date": null,
      "affidavit_status": "PENDING_TM_REVIEW",
      "cancel_job_reason": null,
      "affidavit_uploaded_at": "2020-10-04 01:07:06",
      "salesforce_id": null,
      "archived": false,
      "off_app_assigned_to": "NOT_ASSIGNED",
      "salesforce_user_id": "",
      "affidavit_due_at": null,
      "affidavit_reminders_sent": 0,
      "last_affidavit_reminder_sent_at": null,
      "attempt_reminders_sent": 0,
      "last_attempt_reminder_sent_at": null,
      "signed_affidavit_url": null,
      "base_fee": 25,
      "bounty": 50,
      "post_price": 45,
      "starred": false,
      "server": {
        "id": 6,
        "law_firm_id": null,
        "type": "SERVER",
        "name": "Test Server",
        "last_name": "Server",
        "first_name": "Test",
        "active": 1,
        "email": "server@proofserve.com",
        "administrator": false,
        "phone_number": "7347304250",
        "state_id": 1,
        "created_at": 1548158103000,
        "updated_at": 1602128137000,
        "deleted_at": null,
        "total_job_count": 13,
        "total_job_count_5_stars": 1,
        "coupon_code": null,
        "last_cdp_update": null,
        "email_affidavits": false,
        "state": {
          "id": 1,
          "name": "Colorado",
          "abbreviation": "CO",
          "allow_jobs": true,
          "allow_residential_sub": true,
          "allow_work_sub": true,
          "created_at": 1596844801000,
          "updated_at": 1596844801000,
          "deleted_at": null,
          "affidavit_service_title": "Affidavit of Service",
          "affidavit_nonservice_title": "Affidavit of Nonservice",
          "requires_notary_service": true,
          "requires_notary_nonservice": true,
          "allow_sunday_serve": 1,
          "average_server_rating": 5,
          "summons_serve_stamp": false,
          "attach_summons_position": "PREPENDED",
          "show_prior_attempts_posting": 0
        }
      },
      "servee": {
        "id": 7,
        "type": "INDIVIDUAL",
        "job_id": 8,
        "name": "Jane Smith",
        "registered_agent_name": null,
        "physical_description": true,
        "race": "White",
        "gender": "Male",
        "hair_color": "Brown",
        "marital_status": "Married",
        "eye_glasses": "Yes",
        "height": "5' 9\" to 6'",
        "weight": "160 to 180 lbs",
        "age": 30,
        "notes": "He works from 9-5\nCompany name is Propel Technology",
        "social_links": "https://www.facebook.com/propelitco/",
        "created_at": 1548083163000,
        "updated_at": 1548083163000,
        "deleted_at": null,
        "servee_addresses": [
          {
            "id": 18,
            "servee_id": 7,
            "type": "HOME",
            "business_name": null,
            "address_1": "7154 Eaton Ct",
            "address_2": "",
            "city": "Arvada",
            "state_id": 1,
            "zip": "80003",
            "primary": true,
            "longitude": -105.0596457,
            "latitude": 39.8252367,
            "county": "Jefferson County",
            "created_at": 1548345974000,
            "updated_at": 1558672808000,
            "deleted_at": null,
            "timezone": "America/Denver",
            "state": {
              "id": 1,
              "name": "Colorado",
              "abbreviation": "CO",
              "allow_jobs": true,
              "allow_residential_sub": true,
              "allow_work_sub": true,
              "created_at": 1596844801000,
              "updated_at": 1596844801000,
              "deleted_at": null,
              "affidavit_service_title": "Affidavit of Service",
              "affidavit_nonservice_title": "Affidavit of Nonservice",
              "requires_notary_service": true,
              "requires_notary_nonservice": true,
              "allow_sunday_serve": 1,
              "average_server_rating": 5,
              "summons_serve_stamp": false,
              "attach_summons_position": "PREPENDED",
              "show_prior_attempts_posting": 0
            }
          },
          {
            "id": 206,
            "servee_id": 7,
            "type": "HOME",
            "business_name": null,
            "address_1": "7156 Eaton Ct",
            "address_2": "",
            "city": "Arvada",
            "state_id": 1,
            "zip": "80003",
            "primary": false,
            "longitude": null,
            "latitude": null,
            "county": null,
            "created_at": 1553704234000,
            "updated_at": 1558672808000,
            "deleted_at": null,
            "timezone": "America/Denver",
            "state": {
              "id": 1,
              "name": "Colorado",
              "abbreviation": "CO",
              "allow_jobs": true,
              "allow_residential_sub": true,
              "allow_work_sub": true,
              "created_at": 1596844801000,
              "updated_at": 1596844801000,
              "deleted_at": null,
              "affidavit_service_title": "Affidavit of Service",
              "affidavit_nonservice_title": "Affidavit of Nonservice",
              "requires_notary_service": true,
              "requires_notary_nonservice": true,
              "allow_sunday_serve": 1,
              "average_server_rating": 5,
              "summons_serve_stamp": false,
              "attach_summons_position": "PREPENDED",
              "show_prior_attempts_posting": 0
            }
          }
        ],
        "primary_address": {
          "id": 18,
          "servee_id": 7,
          "type": "HOME",
          "business_name": null,
          "address_1": "7154 Eaton Ct",
          "address_2": "",
          "city": "Arvada",
          "state_id": 1,
          "zip": "80003",
          "primary": true,
          "longitude": -105.0596457,
          "latitude": 39.8252367,
          "county": "Jefferson County",
          "created_at": 1548345974000,
          "updated_at": 1558672808000,
          "deleted_at": null,
          "timezone": "America/Denver",
          "state": {
            "id": 1,
            "name": "Colorado",
            "abbreviation": "CO",
            "allow_jobs": true,
            "allow_residential_sub": true,
            "allow_work_sub": true,
            "created_at": 1596844801000,
            "updated_at": 1596844801000,
            "deleted_at": null,
            "affidavit_service_title": "Affidavit of Service",
            "affidavit_nonservice_title": "Affidavit of Nonservice",
            "requires_notary_service": true,
            "requires_notary_nonservice": true,
            "allow_sunday_serve": 1,
            "average_server_rating": 5,
            "summons_serve_stamp": false,
            "attach_summons_position": "PREPENDED",
            "show_prior_attempts_posting": 0
          }
        }
      },
      "state": {
        "id": 1,
        "name": "Colorado",
        "abbreviation": "CO",
        "allow_jobs": true,
        "allow_residential_sub": true,
        "allow_work_sub": true,
        "created_at": 1596844801000,
        "updated_at": 1596844801000,
        "deleted_at": null,
        "affidavit_service_title": "Affidavit of Service",
        "affidavit_nonservice_title": "Affidavit of Nonservice",
        "requires_notary_service": true,
        "requires_notary_nonservice": true,
        "allow_sunday_serve": 1,
        "average_server_rating": 5,
        "summons_serve_stamp": false,
        "attach_summons_position": "PREPENDED",
        "show_prior_attempts_posting": 0
      },
      "user": {
        "id": 2,
        "law_firm_id": 2,
        "type": "FIRM",
        "name": "Marty Wachocki",
        "last_name": "Wachocki",
        "first_name": "Marty",
        "active": 1,
        "email": "firm@proofserve.com",
        "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
        "email_invoices": true,
        "email_notifications": true,
        "email_verified": true,
        "administrator": true,
        "phone_number": "7347304250",
        "address_1": "7154 Eaton Ct",
        "address_2": null,
        "city": "Arvada",
        "state_id": 1,
        "zip": "80003",
        "created_at": 1548158103000,
        "updated_at": 1608152958000,
        "deleted_at": null,
        "new_user": 0,
        "rating_count": 0,
        "email_chat_messages": 1,
        "email_progress_updates": 1,
        "email_reassigned": 1,
        "email_job_completed": 1,
        "notify_hours": 1,
        "total_job_count": 0,
        "total_job_count_5_stars": 0,
        "table_style": "DEFAULT",
        "coupon_code": null,
        "last_cdp_update": null,
        "email_affidavits": false
      },
      "law_firm": {
        "id": 2,
        "name": "Acme Law Firm",
        "phone_number": "7347304250",
        "email": "marty@wachocki.net",
        "address_1": "8753 Yates Dr",
        "address_2": "#215",
        "city": "Westminster",
        "state_id": 1,
        "zip": "80031",
        "created_at": 1548272881000,
        "updated_at": 1607363359000,
        "deleted_at": null,
        "email_invoices_to": null,
        "free_credits": "475.0000000000",
        "api_enabled": true,
        "private_jobs": false,
        "salesforce_connected": true
      },
      "serve_pricing": {
        "id": 1,
        "name": "Standard",
        "state_id": 1,
        "base_fee": 25,
        "bounty_fee": 50,
        "diy_price": 75,
        "post_price": 45,
        "post_duration": 172800,
        "initial_duration": 604800,
        "total_duration": 604800,
        "total_attempts": 4,
        "updated_at": 1548331771000,
        "created_at": 1548331771000,
        "creditor_only": 0,
        "collection_only": 0
      },
      "offered_server": null,
      "same_address_jobs": [],
      "flags": []
    }
  ]
}

HTTP Request

GET /jobs

Create a job

Example request body:

{
  "court_name": "Denver County Court",
  "court_address": "520 W Colfax Ave, Denver, CO 80204",
  "case_number": "CV-12345",
  "court_date": "2020-07-30",
  "user_id": 2,
  "state_id": 1,
  "post_serve": false,
  "billing_number": "P12345",
  "status": "UNASSIGNED",
  "stripe_card_id": "card_1Dy074Hg213tM5vxjBic4l40",
  "payment_method_id": 1,
  "plaintiffs": [
    {
      "name": "John Doe"
    }
  ],
  "defendants": [
    {
      "name": "Jane Smith"
    }
  ],
  "documents": [
    {
      "id": 894,
      "name": "Summons"
    }
  ],
  "servees": [
    {
      "type": "INDIVIDUAL",
      "name": "Jane Smith",
      "physical_description": true,
      "race": "White",
      "gender": "Male",
      "hair_color": "Blonde",
      "marital_status": "Married",
      "eye_glasses": "No",
      "height": "5' 9\" to 6'",
      "weight": "160 lbs to 180 lbs",
      "age": "35",
      "serve_pricing_id": 1,
      "serve_pricing_name": "Standard",
      "notes": "The servee is usually working from 9am to 5pm.",
      "subpoena": false,
      "authorize_skiptrace": false,
      "same_address": false,
      "documents": [
        894
      ],
      "servee_addresses": [
        {
          "type": "WORK",
          "business_name": "Glade Voogt Lopez Smith",
          "address_1": "1800 N Gaylord St",
          "address_2": "",
          "city": "Denver",
          "state_id": 1,
          "zip": "80206",
          "primary": true
        },
        {
          "type": "HOME",
          "address_1": "1437 Bannock St",
          "address_2": "",
          "city": "Denver",
          "state_id": 1,
          "zip": "80202"
        }
      ],
      "servee_photos": [
        {
          "id": 155
        }
      ]
    }
  ],
  "special_requirements": [
    {
      "id": 18, 
      "title": "Already existing requirement", 
      "created_at": "2022-09-14T13:23:55.19456Z", 
      "is_default": true, 
      "updated_at": "2022-09-20T18:32:41.295653Z", 
      "instructions": "Please do this additional task"
    },
    {
      "title":"I am a new SOM requirement that will be saved for use again",
      "is_default": true,
      "is_internal": true,
      "save_for_later": true,
      "instructions": "have a good day"
    },
  ]
}

Example response:

{
  "jobs": [
    {
      "court_name": "Denver County Court",
      "court_address": "520 W Colfax Ave, Denver, CO 80204",
      "case_number": "CV-12345",
      "court_date": "2020-07-30",
      "user_id": 2,
      "state_id": 1,
      "billing_number": "P12345",
      "status": "UNASSIGNED",
      "stripe_card_id": "card_1Dy074Hg213tM5vxjBic4l40",
      "originated_at": 1625161317000,
      "serve_pricing_id": 1,
      "authorize_skiptrace": false,
      "post_serve": false,
      "subpoena": false,
      "last_status_change": 1625161317000,
      "law_firm_id": 2,
      "created_by_id": 2,
      "updated_at": 1625161317000,
      "created_at": 1625161317000,
      "id": 256,
      "signed_affidavit_url": null,
      "base_fee": 25,
      "bounty": 50,
      "post_price": 45,
      "servee": {
        "id": 255,
        "type": "INDIVIDUAL",
        "job_id": 256,
        "name": "Jane Smith",
        "registered_agent_name": null,
        "physical_description": true,
        "race": "White",
        "gender": "Male",
        "hair_color": "Blonde",
        "marital_status": "Married",
        "eye_glasses": "No",
        "height": "5' 9\" to 6'",
        "weight": "160 lbs to 180 lbs",
        "age": 35,
        "notes": "The servee is usually working from 9am to 5pm.",
        "social_links": null,
        "created_at": 1625161317000,
        "updated_at": 1625161317000,
        "deleted_at": null,
        "servee_photos": [
          {
            "id": 155,
            "servee_id": 255,
            "filename": "file.png",
            "extension": "png",
            "access_key": "wA4ze91k2pIbOLFUsTWd9ZxvftRLFR4E",
            "created_at": 1625161317000,
            "updated_at": 1625161318000,
            "deleted_at": null,
            "created_by_id": 2,
            "law_firm_id": 2
          }
        ],
        "servee_addresses": [
          {
            "id": 398,
            "servee_id": 255,
            "type": "WORK",
            "business_name": "Glade Voogt Lopez Smith",
            "address_1": "1800 N Gaylord St",
            "address_2": "",
            "city": "Denver",
            "state_id": 1,
            "zip": "80206",
            "primary": true,
            "longitude": -104.9606913,
            "latitude": 39.7450098,
            "county": "Denver County",
            "created_at": 1625161317000,
            "updated_at": 1625161318000,
            "deleted_at": null,
            "timezone": "America/Denver"
          },
          {
            "id": 399,
            "servee_id": 255,
            "type": "HOME",
            "business_name": null,
            "address_1": "1437 Bannock St",
            "address_2": "",
            "city": "Denver",
            "state_id": 1,
            "zip": "80202",
            "primary": false,
            "longitude": -104.9907968,
            "latitude": 39.7392296,
            "county": "Denver County",
            "created_at": 1625161318000,
            "updated_at": 1625161318000,
            "deleted_at": null,
            "timezone": "America/Denver"
          }
        ],
        "primary_address": {
          "id": 398,
          "servee_id": 255,
          "type": "WORK",
          "business_name": "Glade Voogt Lopez Smith",
          "address_1": "1800 N Gaylord St",
          "address_2": "",
          "city": "Denver",
          "state_id": 1,
          "zip": "80206",
          "primary": true,
          "longitude": -104.9606913,
          "latitude": 39.7450098,
          "county": "Denver County",
          "created_at": 1625161317000,
          "updated_at": 1625161318000,
          "deleted_at": null,
          "timezone": "America/Denver"
        }
      },
      "state": {
        "id": 1,
        "name": "Colorado",
        "abbreviation": "CO",
        "allow_jobs": true,
        "allow_residential_sub": true,
        "allow_work_sub": true,
        "created_at": 1596844801000,
        "updated_at": 1596844801000,
        "deleted_at": null,
        "affidavit_service_title": "Affidavit of Service",
        "affidavit_nonservice_title": "Affidavit of Nonservice",
        "requires_notary_service": true,
        "requires_notary_nonservice": true,
        "allow_sunday_serve": 1,
        "average_server_rating": 5,
        "summons_serve_stamp": false,
        "attach_summons_position": "PREPENDED",
        "show_prior_attempts_posting": 0
      },
      "serve_pricing": {
        "id": 1,
        "name": "Standard",
        "state_id": 1,
        "base_fee": 25,
        "bounty_fee": 50,
        "diy_price": 75,
        "post_price": 45,
        "post_duration": 172800,
        "initial_duration": 604800,
        "total_duration": 604800,
        "total_attempts": 4,
        "updated_at": 1548331771000,
        "created_at": 1548331771000,
        "creditor_only": 0,
        "collection_only": 0
      },
      "defendants": [],
      "plaintiffs": [],
      "user": {
        "id": 2,
        "law_firm_id": 2,
        "type": "FIRM",
        "name": "Marty Wachocki",
        "last_name": "Wachocki",
        "first_name": "Marty",
        "active": 1,
        "email": "firm@proofserve.com",
        "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
        "email_invoices": true,
        "email_notifications": true,
        "email_verified": true,
        "administrator": true,
        "phone_number": "7347304250",
        "address_1": "7154 Eaton Ct",
        "address_2": null,
        "city": "Arvada",
        "state_id": 1,
        "zip": "80003",
        "created_at": 1548158103000,
        "updated_at": 1608152958000,
        "deleted_at": null,
        "new_user": 0,
        "rating_count": 0,
        "email_chat_messages": 1,
        "email_progress_updates": 1,
        "email_reassigned": 1,
        "email_job_completed": 1,
        "notify_hours": 1,
        "total_job_count": 0,
        "total_job_count_5_stars": 0,
        "table_style": "DEFAULT",
        "coupon_code": null,
        "last_cdp_update": null,
        "email_affidavits": false
      }
    }
  ]
}

HTTP Request

POST /jobs

Tips:

Request Parameters

Parameter Description
court_name
string
court_address
string
case_number
string
court_date
string
user_id
int, required
References a user's id
state_id
integer, required
Reference state id from Get All States
billing_number
string, required
This should be a unique internal reference #.
status
string, required
One of: DRAFT, UNASSIGNED
stripe_card_id
string, required
DEPRECATED: see payment_method_id
post_serve
boolean
Default: false
payment_method_id
int, required
Reference id from Get payment methods. Used in place of stripe_card_id.
plaintiffs
array
plaintiffs.*.name
string, required
defendants
array
defendants.*.name
string, required
documents
array, required
documents.*.id
integer, required
Reference previously uploaded document id from Upload Document
documents.*.name
string, required
servees
array, required
servees.*.type
string, required
One of: INDIVIDUAL, ENTITY
servees.*.name
string, required
servees.*.physical_description
boolean
Default: false
servees.*.race
string
If physical_description is false, don't provide.
servees.*.gender
string
If physical_description is false, don't provide.
servees.*.hair_color
string
If physical_description is false, don't provide.
servees.*.marital_status
string
If physical_description is false, don't provide.
servees.*.eye_glasses
string
If physical_description is false, don't provide.
servees.*.height
string
If physical_description is false, don't provide.
servees.*.weight
string
If physical_description is false, don't provide.
servees.*.age
string
If physical_description is false, don't provide.
servees.*.serve_pricing_id
integer, required
References serve pricing id from Get Serve Pricings ID from the state_id.
servees.*.serve_pricing_name
string, required
servees.*.notes
string
servees.*.subpoena
boolean
Default: false
servees.*.authorize_skiptrace
boolean
Default: false
servees.*.same_address
boolean|integer
Default: false. If not false, it should be the index of the parent servee at the same address.
servees.*.documents
array, required
servees.*.documents.*
integer, required
Reference previously uploaded document id from Upload Document
servees.*.servee_addresses
array, required
servees.*.servee_addresses.*.type
string, required
One of: HOME, WORK, REGISTERED_AGENT, ENTITY, OTHER
servees.*.servee_addresses.*.business_name
array
Should be provided if type is one of WORK, REGISTERED_AGENT, ENTITY
servees.*.servee_addresses.*.address_1
string, required
servees.*.servee_addresses.*.address_2
string
servees.*.servee_addresses.*.city
string, required
servees.*.servee_addresses.*.state_id
integer, required
Reference state id from Get All States
servees.*.servee_addresses.*.zip
string, required
servees.*.servee_addresses.*.primary
boolean, required
Only one address should be have primary to true
servees.*.servee_photos
array
servees.*.servee_photos.*.id
integer, required
References servee photo id from Upload Servee Photo.
special_requirements
array SpecialRequirement, Max 8
JSON object from Get special requirements

Get job

Example response:

{
  "id": 160,
  "user_id": 2,
  "law_firm_id": 2,
  "server_id": 14,
  "original_job_id": null,
  "new_job_id": null,
  "status": "PENDING_NOTARY",
  "contact_first_name": "Marty",
  "contact_last_name": "Wachocki",
  "contact_email": "marty@propeltechnology.com",
  "contact_phone": "7347304250",
  "billing_number": "123",
  "court_name": "District Court, County Of Adams, State Of",
  "case_number": "2018CV31346",
  "state_id": 1,
  "serve_pricing_id": 2,
  "stripe_card_id": "card_1Dy074Hg213tM5vxjBic4l40",
  "post_serve": false,
  "assign_date": "2019-04-04 20:05:30",
  "created_by_id": 2,
  "attempts_made": 1,
  "last_attempt": "2019-04-04 20:35:29",
  "successful_attempt": true,
  "successful_at": 1554410129000,
  "completed_at": null,
  "due_date": 1554667530000,
  "originated_at": 1554126237000,
  "subpoena": false,
  "witness_fee": null,
  "authorize_skiptrace": false,
  "affidavit_extension": null,
  "review_period_ends": null,
  "created_at": 1554126237000,
  "updated_at": 1625156672000,
  "deleted_at": null,
  "same_address_job_id": null,
  "attorney_name": null,
  "attorney_bar_number": null,
  "court_street_address": null,
  "court_mailing_address": null,
  "court_city": null,
  "court_zip": null,
  "court_branch_name": null,
  "court_address": null,
  "last_status_change": null,
  "court_date": null,
  "affidavit_status": "PENDING_TM_REVIEW",
  "cancel_job_reason": null,
  "affidavit_uploaded_at": "2020-09-29 05:45:04",
  "salesforce_id": null,
  "archived": false,
  "off_app_assigned_to": "NOT_ASSIGNED",
  "salesforce_user_id": "",
  "affidavit_due_at": "2021-07-02 04:24:32",
  "affidavit_reminders_sent": 0,
  "last_affidavit_reminder_sent_at": null,
  "attempt_reminders_sent": 0,
  "last_attempt_reminder_sent_at": null,
  "signed_affidavit_url": null,
  "base_fee": 45,
  "bounty": 80,
  "post_price": 0,
  "starred": false,
  "territory_manager": null,
  "servee": {
    "id": 159,
    "type": "INDIVIDUAL",
    "job_id": 160,
    "name": "Test Servee",
    "registered_agent_name": null,
    "physical_description": false,
    "race": null,
    "gender": null,
    "hair_color": null,
    "marital_status": "",
    "eye_glasses": null,
    "height": null,
    "weight": null,
    "age": null,
    "notes": null,
    "social_links": null,
    "created_at": 1554126237000,
    "updated_at": 1554126237000,
    "deleted_at": null,
    "servee_addresses": [
      {
        "id": 209,
        "servee_id": 159,
        "type": "HOME",
        "business_name": null,
        "address_1": "8120 Sheridan Boulevard",
        "address_2": "",
        "city": "Arvada",
        "state_id": 6,
        "zip": "80003",
        "primary": true,
        "longitude": -105.052024,
        "latitude": 39.8437682,
        "county": "Adams County",
        "created_at": 1554126238000,
        "updated_at": 1558672808000,
        "deleted_at": null,
        "timezone": "America/Denver",
        "state": {
          "id": 6,
          "name": "Alabama",
          "abbreviation": "AL",
          "allow_jobs": true,
          "allow_residential_sub": false,
          "allow_work_sub": false,
          "created_at": 1557771726000,
          "updated_at": 1553048780000,
          "deleted_at": null,
          "affidavit_service_title": "Affidavit of Service",
          "affidavit_nonservice_title": "Affidavit of Nonservice",
          "requires_notary_service": false,
          "requires_notary_nonservice": false,
          "allow_sunday_serve": 1,
          "average_server_rating": 0,
          "summons_serve_stamp": false,
          "attach_summons_position": "PREPENDED",
          "show_prior_attempts_posting": 0
        }
      },
      {
        "id": 210,
        "servee_id": 159,
        "type": "ENTITY",
        "business_name": null,
        "address_1": "7395 S Peoria St",
        "address_2": "# 105",
        "city": "Englewood",
        "state_id": 6,
        "zip": "80112",
        "primary": false,
        "longitude": -104.8460701,
        "latitude": 39.5823553,
        "county": "Arapahoe County",
        "created_at": 1554126238000,
        "updated_at": 1558672808000,
        "deleted_at": null,
        "timezone": "America/Denver",
        "state": {
          "id": 6,
          "name": "Alabama",
          "abbreviation": "AL",
          "allow_jobs": true,
          "allow_residential_sub": false,
          "allow_work_sub": false,
          "created_at": 1557771726000,
          "updated_at": 1553048780000,
          "deleted_at": null,
          "affidavit_service_title": "Affidavit of Service",
          "affidavit_nonservice_title": "Affidavit of Nonservice",
          "requires_notary_service": false,
          "requires_notary_nonservice": false,
          "allow_sunday_serve": 1,
          "average_server_rating": 0,
          "summons_serve_stamp": false,
          "attach_summons_position": "PREPENDED",
          "show_prior_attempts_posting": 0
        }
      },
      {
        "id": 211,
        "servee_id": 159,
        "type": "HOME",
        "business_name": null,
        "address_1": "9852 W 76th Ave",
        "address_2": "",
        "city": "Arvada",
        "state_id": 6,
        "zip": "80005",
        "primary": false,
        "longitude": -105.1080116,
        "latitude": 39.8340379,
        "county": "Jefferson County",
        "created_at": 1554126239000,
        "updated_at": 1558672808000,
        "deleted_at": null,
        "timezone": "America/Denver",
        "state": {
          "id": 6,
          "name": "Alabama",
          "abbreviation": "AL",
          "allow_jobs": true,
          "allow_residential_sub": false,
          "allow_work_sub": false,
          "created_at": 1557771726000,
          "updated_at": 1553048780000,
          "deleted_at": null,
          "affidavit_service_title": "Affidavit of Service",
          "affidavit_nonservice_title": "Affidavit of Nonservice",
          "requires_notary_service": false,
          "requires_notary_nonservice": false,
          "allow_sunday_serve": 1,
          "average_server_rating": 0,
          "summons_serve_stamp": false,
          "attach_summons_position": "PREPENDED",
          "show_prior_attempts_posting": 0
        }
      }
    ],
    "servee_marks": [],
    "servee_photos": [],
    "primary_address": {
      "id": 209,
      "servee_id": 159,
      "type": "HOME",
      "business_name": null,
      "address_1": "8120 Sheridan Boulevard",
      "address_2": "",
      "city": "Arvada",
      "state_id": 6,
      "zip": "80003",
      "primary": true,
      "longitude": -105.052024,
      "latitude": 39.8437682,
      "county": "Adams County",
      "created_at": 1554126238000,
      "updated_at": 1558672808000,
      "deleted_at": null,
      "timezone": "America/Denver"
    }
  },
  "invoice": null,
  "line_items": [],
  "flags": [],
  "user": {
    "id": 2,
    "law_firm_id": 2,
    "type": "FIRM",
    "name": "Marty Wachocki",
    "last_name": "Wachocki",
    "first_name": "Marty",
    "active": 1,
    "email": "firm@proofserve.com",
    "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
    "email_invoices": true,
    "email_notifications": true,
    "email_verified": true,
    "administrator": true,
    "phone_number": "7347304250",
    "address_1": "7154 Eaton Ct",
    "address_2": null,
    "city": "Arvada",
    "state_id": 1,
    "zip": "80003",
    "created_at": 1548158103000,
    "updated_at": 1608152958000,
    "deleted_at": null,
    "new_user": 0,
    "rating_count": 0,
    "email_chat_messages": 1,
    "email_progress_updates": 1,
    "email_reassigned": 1,
    "email_job_completed": 1,
    "notify_hours": 1,
    "total_job_count": 0,
    "total_job_count_5_stars": 0,
    "table_style": "DEFAULT",
    "coupon_code": null,
    "last_cdp_update": null,
    "email_affidavits": false,
    "law_firm": {
      "id": 2,
      "name": "Acme Law Firm",
      "phone_number": "7347304250",
      "email": "marty@wachocki.net",
      "address_1": "8753 Yates Dr",
      "address_2": "#215",
      "city": "Westminster",
      "state_id": 1,
      "zip": "80031",
      "created_at": 1548272881000,
      "updated_at": 1607363359000,
      "deleted_at": null,
      "email_invoices_to": null,
      "free_credits": "475.0000000000",
      "api_enabled": true,
      "private_jobs": false,
      "salesforce_connected": true
    }
  },
  "law_firm": {
    "id": 2,
    "name": "Acme Law Firm",
    "phone_number": "7347304250",
    "email": "marty@wachocki.net",
    "address_1": "8753 Yates Dr",
    "address_2": "#215",
    "city": "Westminster",
    "state_id": 1,
    "zip": "80031",
    "created_at": 1548272881000,
    "updated_at": 1607363359000,
    "deleted_at": null,
    "email_invoices_to": null,
    "free_credits": "475.0000000000",
    "api_enabled": true,
    "private_jobs": false,
    "salesforce_connected": true
  },
  "state": {
    "id": 1,
    "name": "Colorado",
    "abbreviation": "CO",
    "allow_jobs": true,
    "allow_residential_sub": true,
    "allow_work_sub": true,
    "created_at": 1596844801000,
    "updated_at": 1596844801000,
    "deleted_at": null,
    "affidavit_service_title": "Affidavit of Service",
    "affidavit_nonservice_title": "Affidavit of Nonservice",
    "requires_notary_service": true,
    "requires_notary_nonservice": true,
    "allow_sunday_serve": 1,
    "average_server_rating": 5,
    "summons_serve_stamp": false,
    "attach_summons_position": "PREPENDED",
    "show_prior_attempts_posting": 0
  },
  "serve_pricing": {
    "id": 2,
    "name": "Expedited",
    "state_id": 1,
    "base_fee": 45,
    "bounty_fee": 80,
    "diy_price": 125,
    "post_price": null,
    "post_duration": null,
    "initial_duration": 259200,
    "total_duration": 259200,
    "total_attempts": 4,
    "updated_at": 1548331771000,
    "created_at": 1548331771000,
    "creditor_only": 0,
    "collection_only": 0
  },
  "server": {
    "id": 14,
    "law_firm_id": null,
    "type": "SERVER",
    "name": "Mark Kreloff",
    "last_name": "Kreloff",
    "first_name": "Mark",
    "active": 1,
    "email": "mark@proofserve.com",
    "administrator": false,
    "phone_number": "6477676186",
    "state_id": 46,
    "created_at": 1548158103000,
    "updated_at": 1607926553000,
    "deleted_at": null,
    "total_job_count": 51,
    "total_job_count_5_stars": 5,
    "coupon_code": null,
    "last_cdp_update": null,
    "email_affidavits": false,
    "state": {
      "id": 46,
      "name": "Tennessee",
      "abbreviation": "TN",
      "allow_jobs": true,
      "allow_residential_sub": false,
      "allow_work_sub": false,
      "created_at": 1596844801000,
      "updated_at": 1596844801000,
      "deleted_at": null,
      "affidavit_service_title": "Return of Service",
      "affidavit_nonservice_title": "Return of Nonservice",
      "requires_notary_service": true,
      "requires_notary_nonservice": true,
      "allow_sunday_serve": 0,
      "average_server_rating": 5,
      "summons_serve_stamp": false,
      "attach_summons_position": "PREPENDED",
      "show_prior_attempts_posting": 0
    }
  },
  "created_by": {
    "id": 2,
    "law_firm_id": 2,
    "type": "FIRM",
    "name": "Marty Wachocki",
    "last_name": "Wachocki",
    "first_name": "Marty",
    "active": 1,
    "email": "firm@proofserve.com",
    "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
    "email_invoices": true,
    "email_notifications": true,
    "email_verified": true,
    "administrator": true,
    "phone_number": "7347304250",
    "address_1": "7154 Eaton Ct",
    "address_2": null,
    "city": "Arvada",
    "state_id": 1,
    "zip": "80003",
    "created_at": 1548158103000,
    "updated_at": 1608152958000,
    "deleted_at": null,
    "new_user": 0,
    "rating_count": 0,
    "email_chat_messages": 1,
    "email_progress_updates": 1,
    "email_reassigned": 1,
    "email_job_completed": 1,
    "notify_hours": 1,
    "total_job_count": 0,
    "total_job_count_5_stars": 0,
    "table_style": "DEFAULT",
    "coupon_code": null,
    "last_cdp_update": null,
    "email_affidavits": false
  },
  "attempts": [
    {
      "id": 36,
      "job_id": 160,
      "server_id": 14,
      "servee_address_id": 210,
      "success": true,
      "description": "Served.",
      "latitude": 40.0207994301,
      "longitude": -105.2732255464,
      "race": "White",
      "gender": "Female",
      "hair_color": "Other",
      "eye_glasses": "Unknown",
      "height": "4' 9\" to 5'",
      "weight": "180 lbs to 200 lbs",
      "age": 33,
      "service_type": "WORK_SUB",
      "service_type_other": null,
      "substitute_company": null,
      "substitute_name": "Lori Davis",
      "substitute_title": "Chief",
      "attempt_date": 1554435329000,
      "created_at": 1554410129000,
      "updated_at": 1554410129000,
      "deleted_at": null,
      "mailed": false,
      "mailed_from": null,
      "mailed_on": null,
      "mailed_address_id": null,
      "bad_address": false,
      "address": {
        "id": 210,
        "servee_id": 159,
        "type": "ENTITY",
        "business_name": null,
        "address_1": "7395 S Peoria St",
        "address_2": "# 105",
        "city": "Englewood",
        "state_id": 6,
        "zip": "80112",
        "primary": false,
        "longitude": -104.8460701,
        "latitude": 39.5823553,
        "county": "Arapahoe County",
        "created_at": 1554126238000,
        "updated_at": 1558672808000,
        "deleted_at": null,
        "timezone": "America/Denver",
        "state": {
          "id": 6,
          "name": "Alabama",
          "abbreviation": "AL",
          "allow_jobs": true,
          "allow_residential_sub": false,
          "allow_work_sub": false,
          "created_at": 1557771726000,
          "updated_at": 1553048780000,
          "deleted_at": null,
          "affidavit_service_title": "Affidavit of Service",
          "affidavit_nonservice_title": "Affidavit of Nonservice",
          "requires_notary_service": false,
          "requires_notary_nonservice": false,
          "allow_sunday_serve": 1,
          "average_server_rating": 0,
          "summons_serve_stamp": false,
          "attach_summons_position": "PREPENDED",
          "show_prior_attempts_posting": 0
        }
      },
      "mailed_address": null,
      "attempt_photos": [
        {
          "id": 37,
          "attempt_id": 36,
          "extension": "jpg",
          "include_in_affidavit": true,
          "created_at": 1554410129000,
          "updated_at": 1554410129000,
          "deleted_at": null
        }
      ],
      "documents": [
        {
          "id": 380,
          "name": "Subpoena",
          "filename": "Martinez Subpoena to Boulder Neurosurgical.pdf",
          "extension": "pdf",
          "size": 41212,
          "law_firm_id": null,
          "created_by_id": 2,
          "created_at": 1554126204000,
          "updated_at": 1554126239000,
          "deleted_at": null,
          "page_count": 0,
          "pivot": {
            "attempt_id": 36,
            "document_id": 380
          }
        }
      ]
    }
  ],
  "stripe_card": {
    "id": 2,
    "label": "Marty's Card",
    "stripe_id": "card_1Dy074Hg213tM5vxjBic4l40",
    "user_id": 2,
    "law_firm_id": 2,
    "shared": true,
    "created_at": 1548731467000,
    "updated_at": 1551664188000
  },
  "messages": [
    {
      "id": 212,
      "user_id": 13,
      "job_id": 160,
      "message": "Hello",
      "read": 0,
      "created_at": 1625159254000,
      "updated_at": 1625159254000,
      "deleted_at": null,
      "system": false,
      "user": {
        "id": 13,
        "law_firm_id": null,
        "type": "PROOF",
        "name": "Admin Wachocki",
        "last_name": "Wachocki",
        "first_name": "Admin",
        "active": 1,
        "email": "admin@proofserve.com",
        "administrator": false,
        "phone_number": null,
        "state_id": 1,
        "created_at": 1550875352000,
        "updated_at": 1602128130000,
        "deleted_at": null,
        "total_job_count": 0,
        "total_job_count_5_stars": 0,
        "coupon_code": null,
        "last_cdp_update": null,
        "email_affidavits": false
      }
    }
  ],
  "defendants": [
    {
      "id": 186,
      "job_id": 160,
      "name": "Catholic Health Initiatives Colorado D/b/a St. Anthony Hospital North",
      "created_at": 1554126239000,
      "updated_at": 1554126239000,
      "deleted_at": null
    }
  ],
  "documents": [
    {
      "id": 380,
      "name": "Subpoena",
      "filename": "Martinez Subpoena to Boulder Neurosurgical.pdf",
      "extension": "pdf",
      "size": 41212,
      "law_firm_id": null,
      "created_by_id": 2,
      "created_at": 1554126204000,
      "updated_at": 1554126239000,
      "deleted_at": null,
      "page_count": 0,
      "pivot": {
        "job_id": 160,
        "document_id": 380,
        "name": "Subpoena"
      }
    }
  ],
  "plaintiffs": [
    {
      "id": 128,
      "job_id": 160,
      "name": "Linda Martinez",
      "created_at": 1554126239000,
      "updated_at": 1554126239000,
      "deleted_at": null
    }
  ],
  "original_job": null,
  "new_job": null,
  "same_address_job": null,
  "same_address_jobs": []
}

HTTP Request

GET /jobs/{job_id}

Cancel job

Example response:

{
  "success": true
}

HTTP Request

POST /jobs/{job_id}/cancel

Extend job deadline

Example request body:

{
  "days": 2
}

Example response:

{
  "due_date": 1554840330000
}

HTTP Request

POST /jobs/{job_id}/extend

Request Parameters

Parameter Description
days
float, required
The number of days to extend the job due_date by. This can include decimal points (e.g. 2.5 days)

Flag a job

Example request body:

{
  "type": "AFFIDAVIT_CHANGES",
  "description": "Could you please make X correction in the affidavit?"
}

Example response:

{
  "type": "AFFIDAVIT_CHANGES",
  "description": "Could you please make X correction in the affidavit?",
  "created_by_id": 13,
  "job_id": 160,
  "updated_at": 1625161316000,
  "created_at": 1625161316000,
  "id": 61
}

HTTP Request

POST /jobs/{job_id}/flag

Request Parameters

Parameter Description
type
string, required
One of: BAD_ADDRESS, MISSING_INFORMATION, AFFIDAVIT_CHANGES, OTHER
description
string, required

Resolve a flag

Example request body:

{
  "resolution_notes": "We have updated the address."
}

Example response:

{
  "id": 62,
  "job_id": 160,
  "created_by_id": 13,
  "type": "AFFIDAVIT_CHANGES",
  "description": "Could you please make X correction in the affidavit?",
  "resolved": true,
  "resolution_notes": "We have updated the address.",
  "resolved_by_id": 13,
  "created_at": 1625161316000,
  "updated_at": 1625161316000
}

HTTP Request

POST /jobs/{job_id}/flag/{flag_id}/resolve

Request Parameters

Parameter Description
resolution_notes
string

Send chat message

Example request body:

{
  "message": "This is an example chat message."
}

Example response:

{
  "message": "This is an example chat message.",
  "job_id": 160,
  "user_id": 2,
  "updated_at": 1625161314000,
  "created_at": 1625161314000,
  "id": 223
}

HTTP Request

POST /jobs/{job_id}/messages

Request Parameters

Parameter Description
message
string, required

Get chat messages

Example response:

[
  {
    "id": 212,
    "user_id": 13,
    "job_id": 160,
    "message": "Hello",
    "read": 0,
    "created_at": 1625159254000,
    "updated_at": 1625159254000,
    "deleted_at": null,
    "system": false,
    "user": {
      "id": 13,
      "law_firm_id": null,
      "type": "PROOF",
      "name": "Admin Wachocki",
      "last_name": "Wachocki",
      "first_name": "Admin",
      "active": 1,
      "email": "admin@proofserve.com",
      "administrator": false,
      "phone_number": null,
      "state_id": 1,
      "created_at": 1550875352000,
      "updated_at": 1602128130000,
      "deleted_at": null,
      "total_job_count": 0,
      "total_job_count_5_stars": 0,
      "coupon_code": null,
      "last_cdp_update": null,
      "email_affidavits": false,
      "law_firm": null
    }
  }
]

HTTP Request

GET /jobs/{job_id}/messages

Mark messages as read

Example response:

{
  "success": true
}

HTTP Request

POST /jobs/{job_id}/messages/{message_id}/read

Mark a given message as read, as well as all messages sent previous to that message.

Add an address

Example request body:

{
  "type": "WORK",
  "business_name": "Acme Corp, Inc.",
  "address_1": "12345 Some St.",
  "address_2": null,
  "city": "Denver",
  "state_id": 1,
  "zip": "80014",
  "primary": true
}

Example response:

{
  "type": "WORK",
  "business_name": "Acme Corp, Inc.",
  "address_1": "12345 Some St.",
  "address_2": null,
  "city": "Denver",
  "state_id": 1,
  "zip": "80014",
  "primary": true,
  "servee_id": 159,
  "county": "Denver County",
  "latitude": 39.7811727,
  "longitude": -104.9133288,
  "timezone": "America/Denver",
  "updated_at": 1625161315000,
  "created_at": 1625161315000,
  "id": 395,
  "state": {
    "id": 1,
    "name": "Colorado",
    "abbreviation": "CO",
    "allow_jobs": true,
    "allow_residential_sub": true,
    "allow_work_sub": true,
    "requires_server_identification": false,
    "created_at": 1596844801000,
    "updated_at": 1596844801000,
    "deleted_at": null,
    "hide_caption": 0,
    "caption_id": "co",
    "affidavit_service_title": "Affidavit of Service",
    "affidavit_nonservice_title": "Affidavit of Nonservice",
    "show_prior_attempts": 0,
    "requires_notary_service": true,
    "requires_notary_nonservice": true,
    "attach_summons": false,
    "proof_percent": "0.4500000000",
    "show_photos": 1,
    "custom_affidavit": 0,
    "allow_sunday_serve": 1,
    "average_server_rating": 5,
    "summons_serve_stamp": false,
    "attach_summons_position": "PREPENDED",
    "show_prior_attempts_posting": 0
  }
}

HTTP Request

POST /jobs/{job_id}/servees/{servee_id}/addresses

Delete an address

Example response:

{
  "success": true
}

HTTP Request

DELETE /jobs/{job_id}/servees/{servee_id}/addresses/{address_id}

Law Firms

Get current law firm

Example response:

{
  "id": 2,
  "name": "Acme Law Firm",
  "phone_number": "7347304250",
  "email": "marty@wachocki.net",
  "address_1": "8753 Yates Dr",
  "address_2": "#215",
  "city": "Westminster",
  "state_id": 1,
  "zip": "80031",
  "created_at": 1548272881000,
  "updated_at": 1607363359000,
  "deleted_at": null,
  "email_invoices_to": null,
  "free_credits": "475.0000000000",
  "api_enabled": true,
  "private_jobs": false,
  "salesforce_connected": true,
  "primary_billing_contact_email": "user@email.com",
  "consolidate_invoice_line_items": true,
  "prefix_billing_number_filenames": true,
  "notary_required": false,
  "exempt_witness_fees": false,
  "allow_post_payment": false,
  "collection_firm": true,
  "creditor_firm": true,
  "efile_enabled": true,
  "notary_override": true,

  "automated_statement_emails": true,
  "affidavit_add_all_attempts": true,
  "automated_statement_recipients": "user@email.com",
}

HTTP Request

GET /law-firms/current

Get special requirements

Example response:

[
  {
    "id": 134,
    "title": "aaaaa",
    "instructions": "123",
    "is_default": true,
    "law_firm_id": 2,
    "last_updated_by": {
      "id": 199,
      "law_firm_id": 2,
      "type": "FIRM",
      "name": "User",
      "last_name": "User",
      "first_name": "User",
      "email": "user@email.com",
      "stripe_default_payment_method_id": null,
      "email_verified": true,
      "phone_number": "111-111-1111",
      "address_1": "1802 N Gaylord St",
      "address_2": "",
      "city": "Denver",
      "state_id": 1,
      "zip": "80206",
      "created_at": 1660062112023,
      "updated_at": 1683913724176,
      "new_user": true,
      "notes": null,
      "notify_hours": 1,
      "email_affidavits": true,
      "active": true,
      "email_chat_messages": true,
      "email_progress_updates": true,
      "email_reassigned": true,
      "email_job_completed": true,
      "email_job_pending_firm_action": true,
      "email_invoices": true,
      "email_notifications": true,
      "administrator": false,
    },
    "created_at": "2023-04-06T12:37:18.084663Z",
    "updated_at": "2023-04-06T12:37:18.084663Z"
  }
]

HTTP Request

GET /law-firms/{law-firm-id}/special-requirement

Create a special requirement

Special requirements are used to add additional requirements for the Server Ops Manager or Server to a job.

Example request body:

 {
    "title": "Back door check",
    "instructions": "please check the back door",
    "is_default": true,
    "is_internal": false,
    "states":[1,2]
 }

Example response:

{
  "id": 133,
  "instructions": "new requirement",
  "is_default": true,
  "is_internal": true,
  "last_updated_by_id": 162,
  "law_firm_id": 2,
  "title": "My New Req",
  "created_at": "2023-10-03T14:40:58.507102923Z",
  "updated_at": "2023-10-03T14:40:58.507103173Z",
  "deleted_at": null
}

HTTP Request

POST /law-firms/{law-firm-id}/special-requirement

Notifications

Get notifications

Example response:

[
  {
    "id": 327,
    "user_id": 2,
    "job_id": 160,
    "type": "MESSAGE",
    "author_id": 13,
    "action": null,
    "message": "Hello",
    "message_2": null,
    "emailed": 0,
    "read": false,
    "created_at": 1625159254000,
    "updated_at": 1625159254000,
    "message_id": 212,
    "author_system": 0,
    "author": {
      "id": 13,
      "law_firm_id": null,
      "type": "PROOF",
      "name": "Admin Wachocki",
      "last_name": "Wachocki",
      "first_name": "Admin",
      "active": 1,
      "email": "admin@proofserve.com",
      "administrator": false,
      "phone_number": null,
      "state_id": 1,
      "created_at": 1550875352000,
      "updated_at": 1602128130000,
      "deleted_at": null,
      "total_job_count": 0,
      "total_job_count_5_stars": 0,
      "coupon_code": null,
      "last_cdp_update": null,
      "email_affidavits": false
    },
    "job": {
      "id": 160,
      "user_id": 2,
      "law_firm_id": 2,
      "server_id": 14,
      "original_job_id": null,
      "new_job_id": null,
      "status": "PENDING_NOTARY",
      "contact_first_name": "Marty",
      "contact_last_name": "Wachocki",
      "contact_email": "marty@propeltechnology.com",
      "contact_phone": "7347304250",
      "billing_number": "123",
      "court_name": "District Court, County Of Adams, State Of",
      "case_number": "2018CV31346",
      "state_id": 1,
      "serve_pricing_id": 2,
      "stripe_card_id": "card_1Dy074Hg213tM5vxjBic4l40",
      "post_serve": false,
      "assign_date": "2019-04-04 20:05:30",
      "created_by_id": 2,
      "attempts_made": 1,
      "last_attempt": "2019-04-04 20:35:29",
      "successful_attempt": true,
      "successful_at": 1554410129000,
      "completed_at": null,
      "due_date": 1554667530000,
      "originated_at": 1554126237000,
      "subpoena": false,
      "witness_fee": null,
      "authorize_skiptrace": false,
      "affidavit_extension": null,
      "review_period_ends": null,
      "created_at": 1554126237000,
      "updated_at": 1625156672000,
      "deleted_at": null,
      "same_address_job_id": null,
      "attorney_name": null,
      "attorney_bar_number": null,
      "court_street_address": null,
      "court_mailing_address": null,
      "court_city": null,
      "court_zip": null,
      "court_branch_name": null,
      "court_address": null,
      "last_status_change": null,
      "court_date": null,
      "affidavit_status": "PENDING_TM_REVIEW",
      "cancel_job_reason": null,
      "affidavit_uploaded_at": "2020-09-29 05:45:04",
      "salesforce_id": null,
      "archived": false,
      "off_app_assigned_to": "NOT_ASSIGNED",
      "salesforce_user_id": "",
      "affidavit_due_at": "2021-07-02 04:24:32",
      "affidavit_reminders_sent": 0,
      "last_affidavit_reminder_sent_at": null,
      "attempt_reminders_sent": 0,
      "last_attempt_reminder_sent_at": null,
      "signed_affidavit_url": null,
      "base_fee": 45,
      "bounty": 80,
      "post_price": 0,
      "servee": {
        "id": 159,
        "type": "INDIVIDUAL",
        "job_id": 160,
        "name": "Test Servee",
        "registered_agent_name": null,
        "physical_description": false,
        "race": null,
        "gender": null,
        "hair_color": null,
        "marital_status": "",
        "eye_glasses": null,
        "height": null,
        "weight": null,
        "age": null,
        "notes": null,
        "social_links": null,
        "created_at": 1554126237000,
        "updated_at": 1554126237000,
        "deleted_at": null,
        "primary_address": {
          "id": 209,
          "servee_id": 159,
          "type": "HOME",
          "business_name": null,
          "address_1": "8120 Sheridan Boulevard",
          "address_2": "",
          "city": "Arvada",
          "state_id": 6,
          "zip": "80003",
          "primary": true,
          "longitude": -105.052024,
          "latitude": 39.8437682,
          "county": "Adams County",
          "created_at": 1554126238000,
          "updated_at": 1558672808000,
          "deleted_at": null,
          "timezone": "America/Denver"
        }
      },
      "serve_pricing": {
        "id": 2,
        "name": "Expedited",
        "state_id": 1,
        "base_fee": 45,
        "bounty_fee": 80,
        "diy_price": 125,
        "post_price": null,
        "post_duration": null,
        "initial_duration": 259200,
        "total_duration": 259200,
        "total_attempts": 4,
        "updated_at": 1548331771000,
        "created_at": 1548331771000,
        "creditor_only": 0,
        "collection_only": 0
      },
      "user": {
        "id": 2,
        "law_firm_id": 2,
        "type": "FIRM",
        "name": "Marty Wachocki",
        "last_name": "Wachocki",
        "first_name": "Marty",
        "active": 1,
        "email": "firm@proofserve.com",
        "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
        "email_invoices": true,
        "email_notifications": true,
        "email_verified": true,
        "administrator": true,
        "phone_number": "7347304250",
        "address_1": "7154 Eaton Ct",
        "address_2": null,
        "city": "Arvada",
        "state_id": 1,
        "zip": "80003",
        "created_at": 1548158103000,
        "updated_at": 1608152958000,
        "deleted_at": null,
        "new_user": 0,
        "rating_count": 0,
        "email_chat_messages": 1,
        "email_progress_updates": 1,
        "email_reassigned": 1,
        "email_job_completed": 1,
        "notify_hours": 1,
        "total_job_count": 0,
        "total_job_count_5_stars": 0,
        "table_style": "DEFAULT",
        "coupon_code": null,
        "last_cdp_update": null,
        "email_affidavits": false,
        "law_firm": {
          "id": 2,
          "name": "Acme Law Firm",
          "phone_number": "7347304250",
          "email": "marty@wachocki.net",
          "address_1": "8753 Yates Dr",
          "address_2": "#215",
          "city": "Westminster",
          "state_id": 1,
          "zip": "80031",
          "created_at": 1548272881000,
          "updated_at": 1607363359000,
          "deleted_at": null,
          "email_invoices_to": null,
          "free_credits": "475.0000000000",
          "api_enabled": true,
          "private_jobs": false,
          "salesforce_connected": true
        }
      }
    }
  }
]

HTTP Request

GET /notifications

Mark notifications as read

Example request body:

{
  "ids": [
    1,
    2,
    3
  ]
}

Example response:

{
  "success": true
}

HTTP Request

POST /notifications/read

Serve Pricings

Get serve pricings

Example response:

[
  {
    "id": 1,
    "name": "Standard",
    "state_id": 1,
    "base_fee": 25,
    "bounty_fee": 50,
    "diy_price": 75,
    "post_price": 45,
    "post_duration": 172800,
    "initial_duration": 604800,
    "total_duration": 604800,
    "total_attempts": 4,
    "updated_at": 1548331771000,
    "created_at": 1548331771000,
    "creditor_only": 0,
    "collection_only": 0
  }
]

HTTP Request

GET /serve-pricings/{state_id}

Get serve pricings by address

Example response:

[
  {
    "id": 1,
    "name": "Standard",
    "state_id": 1,
    "base_fee": 25,
    "bounty_fee": 50,
    "diy_price": 75,
    "post_price": 45,
    "post_duration": 172800,
    "initial_duration": 604800,
    "total_duration": 604800,
    "total_attempts": 4,
    "updated_at": 1548331771000,
    "created_at": 1548331771000,
    "creditor_only": 0,
    "collection_only": 0
  }
]

HTTP Request

GET /serve-pricings/address?address_1=1800+N+Gaylord+St&city=Denver&state_id=1&zip=80206&job_type=SERVE

job_type: SERVE | SITE_VISIT

Servee Photos

Upload servee photo

Example request body:

"<file>"

Example response:

{
  "filename": "file.png",
  "extension": "png",
  "law_firm_id": 2,
  "created_by_id": 2,
  "access_key": "sVUoraXLtzAGtB1NTI3yE7R3QPBCKKx9",
  "updated_at": 1625161318000,
  "created_at": 1625161318000,
  "id": 156
}

HTTP Request

POST /servee-photos

Get servee photo

Example response:

<image file>

HTTP Request

GET /servee-photos/{servee_photo_id}.{ext}

States

Get all states

Example response:

[
  {
    "id": 6,
    "name": "Alabama",
    "abbreviation": "AL",
    "allow_jobs": true,
    "allow_residential_sub": false,
    "allow_work_sub": false,
    "created_at": 1557771726000,
    "updated_at": 1553048780000,
    "deleted_at": null,
    "affidavit_service_title": "Affidavit of Service",
    "affidavit_nonservice_title": "Affidavit of Nonservice",
    "requires_notary_service": false,
    "requires_notary_nonservice": false,
    "allow_sunday_serve": 1,
    "average_server_rating": 0,
    "summons_serve_stamp": false,
    "attach_summons_position": "PREPENDED",
    "show_prior_attempts_posting": 0,
    "serve_pricings": [
      {
        "id": 21,
        "name": "Standard",
        "state_id": 6,
        "base_fee": 35,
        "bounty_fee": 40,
        "diy_price": 75,
        "post_price": 45,
        "post_duration": 172800,
        "initial_duration": 604800,
        "total_duration": 604800,
        "total_attempts": 4,
        "updated_at": 1548331771000,
        "created_at": 1548331771000,
        "creditor_only": 0,
        "collection_only": 0
      },
      {
        "id": 22,
        "name": "Expedited",
        "state_id": 6,
        "base_fee": 45,
        "bounty_fee": 80,
        "diy_price": 125,
        "post_price": null,
        "post_duration": null,
        "initial_duration": 259200,
        "total_duration": 259200,
        "total_attempts": 4,
        "updated_at": 1548331771000,
        "created_at": 1548331771000,
        "creditor_only": 0,
        "collection_only": 0
      },
      {
        "id": 23,
        "name": "Same Day",
        "state_id": 6,
        "base_fee": 75,
        "bounty_fee": 150,
        "diy_price": 225,
        "post_price": null,
        "post_duration": null,
        "initial_duration": 86400,
        "total_duration": 86400,
        "total_attempts": 4,
        "updated_at": 1548331771000,
        "created_at": 1548331771000,
        "creditor_only": 0,
        "collection_only": 0
      },
      {
        "id": 231,
        "name": "Garnishment",
        "state_id": 6,
        "base_fee": 40,
        "bounty_fee": 0,
        "diy_price": 0,
        "post_price": 0,
        "post_duration": 0,
        "initial_duration": 604800,
        "total_duration": 604800,
        "total_attempts": 2,
        "updated_at": 1612845039000,
        "created_at": 1612845039000,
        "creditor_only": 0,
        "collection_only": 1
      }
    ],
    "supplementary_pricings": [
      {
        "id": 19,
        "state_id": 6,
        "name": "Skip Trace",
        "price": "$75",
        "description": "Find updated address(es) for servee.",
        "server_cut": false,
        "server_price": "$41.25",
        "created_at": null,
        "updated_at": null
      },
      {
        "id": 79,
        "state_id": 6,
        "name": "Extended Travel Areas",
        "price": "$50+",
        "description": "A server may charge an additional fee for rural or other areas requiring additional travel time or costs to reach areas.",
        "server_cut": false,
        "server_price": "$27.5+",
        "created_at": null,
        "updated_at": null
      },
      {
        "id": 80,
        "state_id": 6,
        "name": "Witness Fee Convenience Charge",
        "price": "10%",
        "description": "10% of the witness fee amount will be charged for printing & delivery of check. $2 min / $25 max.",
        "server_cut": false,
        "server_price": null,
        "created_at": null,
        "updated_at": null
      },
      {
        "id": 81,
        "state_id": 6,
        "name": "Additional Serve at Same Address",
        "price": "50% reduction",
        "description": "Each Additional Serve at Same Address. 50% reduction in payout on each additional serve at the same address.",
        "server_cut": true,
        "server_price": "50% reduction",
        "created_at": null,
        "updated_at": null
      },
      {
        "id": 82,
        "state_id": 6,
        "name": "Military Base and Jail/Prison Serve",
        "price": "$75",
        "description": "Additional payout for serves at military bases and jails/prisons.",
        "server_cut": true,
        "server_price": "$13.75",
        "created_at": null,
        "updated_at": null
      },
      {
        "id": 83,
        "state_id": 6,
        "name": "On-demand Surveillance",
        "price": "Up to $75/hour",
        "description": "As needed survelliance for evasive servees. 2 hour minimum.",
        "server_cut": false,
        "server_price": "Up to $41.25/hour",
        "created_at": null,
        "updated_at": null
      },
      {
        "id": 84,
        "state_id": 6,
        "name": "Additional Addresses",
        "price": "$35 - $75",
        "description": "If a serve address is updated after a server has made any or all 4 attempts on the original address. The payout is based on the base payout for the type of serve (as listed above).",
        "server_cut": true,
        "server_price": "$16.50 - $41.25",
        "created_at": null,
        "updated_at": null
      },
      {
        "id": 85,
        "state_id": 6,
        "name": "Document Printing",
        "price": "10\u00a2",
        "description": "A fee of 10\u00a2 per page may be added for jobs with more than 100 printed pages.",
        "server_cut": false,
        "server_price": null,
        "created_at": null,
        "updated_at": null
      }
    ]
  }
]

HTTP Request

GET /states

Get state rules

Example response:

[
  {
    "id": 1,
    "state_id": 1,
    "rule": "Test rule #1",
    "created_at": null,
    "updated_at": null
  }
]

HTTP Request

GET /states/{state_id}/rules

Statements

Export statement (csv)

Example response:

<csv file>

HTTP Request

GET /statements/{start}/{end}/csv

URL Parameters

Parameter Description
start
integer, required
UNIX Timestamp in milliseconds
end
integer, required
UNIX Timestamp in milliseconds

Export statement (pdf)

Example response:

<pdf file>

HTTP Request

GET /statements/{start}/{end}/pdf

URL Parameters

Parameter Description
start
integer, required
UNIX Timestamp in milliseconds
end
integer, required
UNIX Timestamp in milliseconds

Users

Get current user

Example response:

{
  "id": 2,
  "law_firm_id": 2,
  "type": "FIRM",
  "name": "Marty Wachocki",
  "last_name": "Wachocki",
  "first_name": "Marty",
  "active": 1,
  "email": "firm@proofserve.com",
  "stripe_default_card_id": "card_1Hz7FKHg213tM5vxSS07Qj5Q",
  "email_invoices": true,
  "email_notifications": true,
  "email_verified": true,
  "administrator": true,
  "phone_number": "7347304250",
  "address_1": "7154 Eaton Ct",
  "address_2": null,
  "city": "Arvada",
  "state_id": 1,
  "zip": "80003",
  "created_at": 1548158103000,
  "updated_at": 1608152958000,
  "deleted_at": null,
  "new_user": 0,
  "rating_count": 0,
  "email_chat_messages": 1,
  "email_progress_updates": 1,
  "email_reassigned": 1,
  "email_job_completed": 1,
  "notify_hours": 1,
  "total_job_count": 0,
  "total_job_count_5_stars": 0,
  "table_style": "DEFAULT",
  "coupon_code": null,
  "last_cdp_update": null,
  "email_affidavits": false,
  "law_firm": {
    "id": 2,
    "name": "Acme Law Firm",
    "phone_number": "7347304250",
    "email": "marty@wachocki.net",
    "address_1": "8753 Yates Dr",
    "address_2": "#215",
    "city": "Westminster",
    "state_id": 1,
    "zip": "80031",
    "created_at": 1548272881000,
    "updated_at": 1607363359000,
    "deleted_at": null,
    "email_invoices_to": null,
    "free_credits": "475.0000000000",
    "api_enabled": true,
    "private_jobs": false,
    "salesforce_connected": true
  },
  "state": {
    "id": 1,
    "name": "Colorado",
    "abbreviation": "CO",
    "allow_jobs": true,
    "allow_residential_sub": true,
    "allow_work_sub": true,
    "created_at": 1596844801000,
    "updated_at": 1596844801000,
    "deleted_at": null,
    "affidavit_service_title": "Affidavit of Service",
    "affidavit_nonservice_title": "Affidavit of Nonservice",
    "requires_notary_service": true,
    "requires_notary_nonservice": true,
    "allow_sunday_serve": 1,
    "average_server_rating": 5,
    "summons_serve_stamp": false,
    "attach_summons_position": "PREPENDED",
    "show_prior_attempts_posting": 0
  },
  "states": []
}

HTTP Request

GET /users/current

Webhooks

Create webhook endpoint

Example response:

{
  "url": "https://example.com/webhook",
  "enabled": true,
  "version": 1,
  "law_firm_id": 2,
  "updated_at": 1625161320000,
  "created_at": 1625161320000,
  "id": 50
}

HTTP Request

POST /webhooks

Get webhook endpoints

Example response:

[
  {
    "id": 51,
    "law_firm_id": 2,
    "url": "https://example.com/webhook",
    "version": 1,
    "enabled": 1,
    "event_job_status_change": 0,
    "event_job_deleted": 0,
    "event_job_extended": 0,
    "event_job_attempt_created": 0,
    "event_job_attempt_updated": 0,
    "event_job_attempt_deleted": 0,
    "event_job_flag_created": 0,
    "event_job_flag_resolved": 0,
    "event_job_chat_message": 0,
    "created_at": 1625161320000,
    "updated_at": 1625161320000
  }
]

HTTP Request

GET /webhooks

Get webhook calls

Example response:

{
  "current_page": 1,
  "data": [
    {
      "id": 5,
      "webhook_endpoint_id": 52,
      "law_firm_id": 2,
      "endpoint_url": "https://example.com/webhook",
      "successful": 1,
      "request_body": "{}",
      "response_body": "{}",
      "response_status_code": 200,
      "attempts": 1,
      "last_attempt": "2021-07-01 17:42:00",
      "created_at": 1625161320000,
      "updated_at": 1625161320000,
      "event": "JOB_STATUS_CHANGE"
    }
  ],
  "first_page_url": "http://localhost:3000/v1/webhooks/calls?page=1",
  "from": 1,
  "last_page": 1,
  "last_page_url": "http://localhost:3000/v1/webhooks/calls?page=1",
  "links": [
    {
      "url": null,
      "label": "pagination.previous",
      "active": false
    },
    {
      "url": "http://localhost:3000/v1/webhooks/calls?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": null,
      "label": "pagination.next",
      "active": false
    }
  ],
  "next_page_url": null,
  "path": "http://localhost:3000/v1/webhooks/calls",
  "per_page": 10,
  "prev_page_url": null,
  "to": 1,
  "total": 1
}

HTTP Request

GET /webhooks/calls

Webhook Events

Webhook endpoints are configured through the web interface in the Billing & Configuration > API page.

In the API page, click Add endpoint to reveal a form to add a new endpoint for receiving events. You can enter any URL as the destination for events. You can choose to be notified of all event types, or only specific ones. You can find a full list of all event types below.

Event types

Event ID Description
JOB_STATUS_CHANGE When a job's status changes (e.g. In Progress -> Pending Notary)
JOB_DELETED When a job is deleted
JOB_EXTENDED When a job's deadline is extended
JOB_ATTEMPT_CREATED When an attempt is created on a given job
JOB_ATTEMPT_UPDATED When an attempt is updated on a given job
JOB_ATTEMPT_DELETED When an attempt is deleted on a given job
JOB_FLAG_CREATED When a job is flagged for any reason (e.g. bad address)
JOB_FLAG_RESOLVED When a job flag is resolved
JOB_CHAT_MESSAGE When a new chat message is received on a job

Webhook payload examples

Example JOB_STATUS_CHANGE payload:

{
  "event": "JOB_STATUS_CHANGE",
  "created_at": 1696337002725,
  "data": {
    "job_id": 3146,
    "old_status": "UNASSIGNED",
    "new_status": "ASSIGNED"
  }
}

Example JOB_DELETED payload:

 {
  "event": "JOB_DELETED",
  "created_at": 1696339533678,
  "data": {
    "job_id": 3146
  }
}

Example JOB_EXTENDED payload:

{
  "event": "JOB_EXTENDED",
  "created_at": 1696340853704,
  "data": {
    "job_id": 3145,
    "days_extended": 7,
    "old_due_date": "2023-10-13T12:37:16.458259Z",
    "new_due_date": "2023-10-20T12:37:16.458259Z"
  }
}

Example JOB_ATTEMPT_CREATED payload:

 {
  "event": "JOB_ATTEMPT_CREATED",
  "created_at": 1696337321265,
  "data": {
    "job_id": 3146,
    "attempt_id": 994,
    "type": true
  }
}

Example JOB_ATTEMPT_UPDATED payload:

{
  "event": "JOB_ATTEMPT_UPDATED",
  "created_at": 1696339428638,
  "data": {
    "job_id": 3146,
    "attempt_id": 994,
    "type": true
  }
}

Example JOB_ATTEMPT_DELETED payload:

 {
  "event": "JOB_ATTEMPT_DELETED",
  "created_at": 1696339533678,
  "data": {
    "job_id": 3146,
    "attempt_id": 994
  }
}

Example JOB_FLAG_CREATED payload:

{
  "event": "JOB_FLAG_CREATED",
  "created_at": 1696341106559,
  "data": {
    "job_id": 3145,
    "flag_id": 412,
    "type": "BAD_ADDRESS",
    "description": "No house on site.",
    "created_by_id": 13,
    "created_by_name": "John Doe",
    "created_by_type": "SERVER"
  }
}

Example JOB_FLAG_RESOLVED payload:

{
  "event": "JOB_FLAG_RESOLVED",
  "created_at": 1696341195035,
  "data": {
    "job_id": 3145,
    "flag_id": 412,
    "type": "BAD_ADDRESS",
    "description": "Ok",
    "ResolvedByID": 14,
    "ResolvedByName": "Jane Doe",
    "ResolvedByType": "PROOF"
  }
}

Example JOB_CHAT_MESSAGE payload:

{
  "event": "JOB_CHAT_MESSAGE",
  "created_at": 1696339851387,
  "data": {
    "job_id": 3146,
    "user_name": "John Doe",
    "user_type": "SERVER",
    "message": "Hello, how are you?"
  }
}

Each webhook request will include the following attributes:

Attribute Description
event The event type that triggered the event
data Data object containing information specific to the event

For testing webhooks, we recommend a useful service called Request Bin, which allows you to inspect arbitrary webhook requests.

If a JOB_STATUS_CHANGE events new_status field is REASSIGNED, an additional field called new_job_id will be present in the data. This is the job ID of the newly created job.