---
updatedAt: 2025-10-02T22:25:55.000Z
agentTools:
  projectIndex: https://developer.bill.com/v2/llms.txt
---

# Get web app URL for a BILL object

Retrieve the unique web app URL for a BILL object. The sandbox URL format is `https://app-stage02.us.bill.com/{object}?id={object_id}`.

This URL is useful for redirecting users from your application to complete operations with the BILL web app. For example, `https://app-stage02.us.bill.com/bill?id={bill_id}` redirects currently signed in users to the specified vendor bill.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Other search operations",
    "version": "2.0",
    "description": "BILL is a cloud-based cash flow management system for an organization's Accounts Payable (AP) and Accounts Receivable (AR) automation.\n * **AP**: Automate workflows to pay vendors bills at scale for the goods and services they provide. Pay vendors with a wide range of payment methods. Generate vendor credits, bill credits, and payment disbursement reports.\n * **AR**: Automate workflows to get paid by customers at scale for the goods and services you provide. Generate and send invoices on a schedule, generate customer and invoice credits, and seamlessly charge authorized customers.\n * **Organization**: Manage your bank accounts (for sending and receiving payments), users (with user roles), and sync with your choice of accounting software.\n\nIntegrate with the BILL API to send and receive payments for your business. See [Support Center](https://help.bill.com/hc/en-us) for resources about using the BILL web app.",
    "contact": {
      "email": "developerprogram@hq.bill.com"
    }
  },
  "servers": [
    {
      "url": "https://api-stage.bill.com/api/v2",
      "description": "Sandbox base URL"
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "java",
      "javascript",
      "python",
      "ruby"
    ]
  },
  "paths": {
    "/GetObjectUrl.json": {
      "post": {
        "summary": "Get web app URL for a BILL object",
        "operationId": "search-getobjecturl",
        "description": "Retrieve the unique web app URL for a BILL object. The sandbox URL format is `https://app-stage02.us.bill.com/{object}?id={object_id}`.\n\nThis URL is useful for redirecting users from your application to complete operations with the BILL web app. For example, `https://app-stage02.us.bill.com/bill?id={bill_id}` redirects currently signed in users to the specified vendor bill.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetObjectUrlResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "devKey",
                  "sessionId",
                  "data"
                ],
                "properties": {
                  "devKey": {
                    "type": "string",
                    "description": "Developer key generated with your BILL developer account"
                  },
                  "sessionId": {
                    "type": "string",
                    "description": "API session ID generated with [`/v2/Login.json`](https://developer.bill.com/reference/auth-login)"
                  },
                  "data": {
                    "$ref": "#/components/schemas/GetObjectUrlRequest"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ]
      },
      "parameters": []
    }
  },
  "components": {
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error_code": {
            "type": "string",
            "description": "Error code (only when `response_status` is `1`)"
          },
          "error_message": {
            "type": "string",
            "description": "Error message (only when `response_status` is `1`)"
          }
        }
      },
      "GetObjectUrlRequest": {
        "type": "object",
        "required": [
          "objectId"
        ],
        "properties": {
          "objectId": {
            "type": "string",
            "description": "BILL-generated ID of the object.\n\nFor example, the BILL-generated object ID for a bill begins with `00n`."
          }
        }
      },
      "GetObjectUrlResponse": {
        "type": "object",
        "properties": {
          "response_status": {
            "type": "integer",
            "description": "Response status.\n* `0`: Success response\n* `1`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_message": {
            "type": "string",
            "description": "Response status.\n* `Success`: Success response\n* `Error`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_data": {
            "type": "object",
            "allOf": [
              {
                "$ref": "#/components/schemas/ErrorResponse"
              }
            ],
            "properties": {
              "url": {
                "type": "string",
                "description": "BILL web app URL for the object"
              }
            }
          }
        }
      }
    }
  }
}
```