What authentication does the BeSmartee API use?

The BeSmartee API uses an API key passed in the Authorization request header. Tokens are issued and revoked through POST /access-token and POST /access-token/destroy. When called via Jentic, the partner key is stored encrypted in your Jentic One instance and never appears in the agent's context.

Can I run a pricing quote without creating a loan first?

Yes. POST /get-ppe-anonymous returns pricing engine results for a borrower scenario without requiring a loan id, and POST /get-apr-closing-costs returns rate and closing cost figures for the same scenario. Use these for site-wide quote widgets or chat assistants before opening a loan.

How do I create a loan through Jentic?

Run pip install jentic and search for 'create mortgage loan in besmartee'. Jentic returns the POST /create-loan operation, the agent loads its schema, and executes with borrower, property, and loan amount fields. Follow up with /add-coborrowers and /upload-documents to complete the file.

What rate limits apply to the BeSmartee API?

The OpenAPI specification does not document explicit rate limits. Treat 429 responses as a back-off signal and consult the BeSmartee documentation at https://api.besmartee.com/api/docs/overview for partner-specific quotas before running bulk imports or pricing sweeps.

Can I place appraisal and AMC orders through the API?

Yes. POST /orders places a vendor or AMC order against a loan, POST /order returns details for a specific order, POST /order/status checks current order state, and POST /order/update applies an update such as a status change or revised due date.

Can I limit what my agent is allowed to do with the BeSmartee API?

Yes. Jentic One runs self-hosted, so your own rules decide which BeSmartee operations and credentials the agent may use. Because BeSmartee uses RPC-style endpoints that take their targets in the request body, you scope the agent to just the operations it needs, such as POST /create-loan or POST /get-apr-closing-costs for pricing quotes. Operations like POST /upload-documents, POST /download-documents, or POST /orders for vendor and AMC placement stay off limits unless you add them, and your encrypted partner key is injected only for the calls you allow.