Submit Reimbursement

Response returns receipt_uuid. Save it for the next step.

Step 2: Create a draft reimbursement from the receipt

ramp reimbursements create {receipt_uuid}

Response returns:

• reimbursement_uuid — the draft reimbursement ID
• suggested_memos — AI-generated memo suggestions based on the receipt
• suggested_codings — suggested accounting category selections
• suggested_funds — suggested spend allocations to charge
• missing_items — what still needs to be filled in before submission
• reimbursement_link — direct link to view in the Ramp app

Step 3: Fill in required fields

Check missing_items from the create response. Common required fields:

Use suggestions from the create response when available:

# Set memo and fund from suggestions
ramp reimbursements edit {reimbursement_uuid} \
  --memo "Coffee with client" \
  --fund_uuid "{suggested_fund_uuid}"

For tracking categories, use --json:

ramp reimbursements edit {reimbursement_uuid} --json '{
  "reimbursement_uuid": "{uuid}",
  "tracking_category_selections": [
    {
      "category_uuid": "{category_uuid}",
      "option_uuid": "{option_uuid}"
    }
  ]
}'

If no suggestions are available for the fund, list the user's funds:

ramp funds list --agent

After each edit, check the response's missing_items. Repeat until all required items are resolved (all false / empty).

Step 4: Confirm with the user

Present the complete reimbursement before submitting:

Ready to submit:
  Amount:    $42.50
  Merchant:  Blue Bottle Coffee
  Memo:      Coffee with client — discussed Q2 roadmap
  Fund:      Social bonding & Team outings 2026
  Category:  70103 - Company Meals
  Receipt:   attached

Submit for approval?

Step 5: Submit

ramp reimbursements submit {reimbursement_uuid}

Response returns reimbursement_uuid and error_message (null on success).

After submitting, tell the user:

• The reimbursement has been submitted for approval
• Link to view it: the reimbursement_link from the create/edit response
• They'll be notified when it's approved

Editing After Rejection

If a reimbursement was rejected and the user wants to fix and resubmit:

# Revert to draft
ramp reimbursements resubmit {reimbursement_uuid}

# Edit as needed
ramp reimbursements edit {reimbursement_uuid} --memo "Updated memo with details"

# Submit again
ramp reimbursements submit {reimbursement_uuid}

Duplicating a Previous Reimbursement

For recurring expenses (e.g., monthly gym membership):

# Find a previous reimbursement to copy
ramp reimbursements list --reimbursements_to_retrieve my_reimbursements --page_size 10

# Duplicate it (creates a new draft with same merchant, memo, fund, categories)
ramp reimbursements duplicate {previous_reimbursement_uuid}

# The duplicate does NOT copy the receipt — upload a new one
ramp receipts upload --content_type "image/jpeg" --filename "gym-apr.jpg" \
  --file_content_base64 "{base64}"

# Attach receipt via edit (receipts attach is for card transactions only)
# Note: if the duplicate is missing a receipt, create a fresh reimbursement
# from the receipt instead of duplicating

# Edit amount/date if needed, then submit
ramp reimbursements submit {new_reimbursement_uuid}

Example Session

User: I bought coffee for a meeting yesterday, here's the receipt ~/Downloads/bluebottle.jpg

Agent: Let me upload that receipt and create a reimbursement.
> base64 -i ~/Downloads/bluebottle.jpg | tr -d '\n'
> ramp receipts upload --content_type "image/jpeg" --filename "bluebottle.jpg" \
>   --file_content_base64 "{base64}"

Receipt uploaded (receipt_uuid: 0e5e5e0b-...).

> ramp reimbursements create 0e5e5e0b-...

Draft created. The receipt shows Blue Bottle Coffee, $12.50.
Suggested memos: "Coffee at Blue Bottle for team meeting"
Suggested fund: "Social bonding & Team outings 2026"
Missing: memo, fund, Category (GL account)

Let me fill in the details using the suggestions:
> ramp reimbursements edit c6698db2-... \
>   --memo "Coffee at Blue Bottle for team meeting" \
>   --fund_uuid "5c87b1bf-..."

All required items resolved. Ready to submit:
  Amount:    $12.50
  Merchant:  Blue Bottle Coffee
  Memo:      Coffee at Blue Bottle for team meeting
  Fund:      Social bonding & Team outings 2026
  Category:  70103 - Company Meals
  Receipt:   attached

Submit for approval?

User: yes

Agent: > ramp reimbursements submit c6698db2-...
Submitted! Your reimbursement is now pending approval.
View it here: https://app.ramp.com/s/reimbursements/c6698db2-...

When NOT to Use

• Approving reimbursements — use approval-dashboard
• Uploading receipts to card transactions — use receipt-compliance
• Editing memos or categories on card transactions — use transaction-cleanup
• Canceling an approved reimbursement — tell the user to contact their manager or use the Ramp app

Gotchas